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à.
DescribeLocationS3
Restituisce i metadati, ad esempio il nome bucket, su una posizione del bucket Amazon S3.
Sintassi della richiesta
{
"LocationArn": "string"
}Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- LocationArn
-
L'Amazon Resource Name (ARN) della posizione del bucket Amazon S3 da descrivere.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$Campo obbligatorio: sì
Sintassi della risposta
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "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.
- AgentArns
-
Se utilizzi DataSync su un AWS Outpost, l'Amazon Resource Name (ARN) degli agenti EC2 distribuiti sul tuo Outpost. Per ulteriori informazioni sul lancio di un DataSync agente su un AWS avamposto, consulta Implementa il tuo DataSync agente su. AWS Outposts
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 elementi.
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$ - CreationTime
-
L'ora in cui è stata creata la posizione del bucket Amazon S3.
Tipo: Timestamp
- LocationArn
-
L'Amazon Resource Name (ARN) del bucket o punto di accesso Amazon S3.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
L'URL della posizione di Amazon S3 descritta.
Tipo: String
Vincoli di lunghezza: lunghezza massima di 4360.
Pattern:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - S3Config
-
Il nome della risorsa Amazon (ARN) del ruolo AWS Identity and Access Management (IAM) usato per accedere a un bucket Amazon S3.
Per informazioni dettagliate sull'utilizzo di tale ruolo, consulta Creazione di una posizione per Amazon S3 nella Guida per l'utente di AWS DataSync.
Tipo: S3Config oggetto
- S3StorageClass
-
La classe di storage Amazon S3 in cui hai scelto di archiviare i file quando questa posizione viene utilizzata come destinazione di attività. Per maggiori informazioni sulle classi di storage S3, consulta Classi di storage di Amazon S3
. Alcune classi di storage hanno comportamenti che possono influire sui costi di storage S3. Per informazioni dettagliate, consulta Considerazioni sull'utilizzo delle classi di storage S3 in. DataSync Tipo: String
Valori validi:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Esempio
L'esempio seguente restituisce informazioni sulla posizione S3 specificata nella richiesta di esempio.
Richiesta di esempio
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Esempio
Questo esempio illustra un utilizzo di DescribeLocation S3.
Risposta di esempio
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "MyBucket.",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
}
"S3StorageClass": "STANDARD"
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
