Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
ListTagsForResource
Elenca tutti i tag associati all'Amazon Resource Name (ARN) specificato. La risorsa può essere un utente, un server o un ruolo.
Sintassi della richiesta
{
"Arn": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- Arn
-
Richiede i tag associati a un particolare Amazon Resource Name (ARN). Un ARN è un identificatore per una AWS risorsa specifica, ad esempio un server, un utente o un ruolo.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.
Modello:
arn:\S+
Campo obbligatorio: sì
- MaxResults
-
Speciifica il numero di tag da restituire come risposta alla richiesta.
ListTagsForResource
Tipo: integer
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
Campo obbligatorio: no
- NextToken
-
Quando si richiedono risultati aggiuntivi dall'
ListTagsForResource
operazione, viene restituito unNextToken
parametro nell'input. È quindi possibile passare un comando successivo alNextToken
parametro per continuare a elencare tag aggiuntivi.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 6144.
Campo obbligatorio: no
Sintassi della risposta
{
"Arn": "string",
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Arn
-
L'ARN di cui hai specificato l'elenco dei tag.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.
Modello:
arn:\S+
- NextToken
-
Quando è possibile ottenere risultati aggiuntivi dalla
ListTagsForResource
chiamata, viene restituito unNextToken
parametro nell'output. È quindi possibile passare un comando successivo alNextToken
parametro per continuare a elencare tag aggiuntivi.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 6144.
- Tags
-
Coppie chiave-valore assegnate a una risorsa, in genere allo scopo di raggruppare e cercare elementi. I tag sono metadati definiti dall'utente.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalServiceError
-
Questa eccezione viene generata quando si verifica un errore nel AWS Transfer Family servizio.
Codice di stato HTTP: 500
- InvalidNextTokenException
-
Il
NextToken
parametro passato non è valido.Codice di stato HTTP: 400
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
Codice di stato HTTP: 500
Esempi
Esempio
L'esempio seguente elenca i tag per la risorsa con l'ARN specificato.
Richiesta di esempio
{
"Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef"
}
Esempio
Questo esempio illustra un utilizzo di. ListTagsForResource
Risposta di esempio
{
"Tags": [
{
"Key": "Name",
"Value": "MyServer"
}
]
}
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: