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à.
TagResource
Associa una coppia chiave-valore a una risorsa, identificata dal relativo Amazon Resource Name (). ARN Le risorse sono utenti, server, ruoli e altre entità.
Non viene restituita alcuna risposta da questa chiamata.
Sintassi della richiesta
{
"Arn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel JSON formato.
- Arn
-
Un Amazon Resource Name (ARN) per una AWS risorsa specifica, come 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ì
- Tags
-
Coppie chiave-valore assegnate ARNs che puoi utilizzare per raggruppare e cercare risorse per tipo. È possibile allegare questi metadati alle risorse (server, utenti, flussi di lavoro e così via) per qualsiasi scopo.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Campo obbligatorio: sì
Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200 con un corpo vuotoHTTP.
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.
HTTPCodice di stato: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
HTTPCodice di stato: 500
Esempi
Esempio
L'esempio seguente aggiunge un tag a un server abilitato al protocollo di trasferimento file.
Richiesta di esempio
{
"Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
"Tags": [
{
"Key": "Group",
"Value": "Europe"
}
]
}Esempio
Questo esempio illustra un utilizzo di. TagResource
Risposta di esempio
HTTP 200 response with an empty HTTP body.
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa opzione API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
