As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
DescribeCluster
Importante
Aviso de fim do suporte: em 12 de novembro de 2024, AWS descontinuaremos os dispositivos Snowball AWS da geração anterior e os dispositivos Snowcone (e). HDD SDD Continuaremos oferecendo suporte aos clientes existentes que usam esses end-of-life dispositivos até 12 de novembro de 2025. Os dispositivos AWS Snowball de última geração estão disponíveis para todos os clientes. Veja esta postagem em blog
Retorna informações sobre um cluster específico, incluindo informações de remessa, o status do cluster e outros metadados importantes.
Sintaxe da Solicitação
{
"ClusterId": "string
"
}
Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- ClusterId
-
O ID gerado automaticamente para um cluster.
Tipo: string
Restrições de tamanho: tamanho fixo de 39.
Padrão:
CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
Exigido: Sim
Sintaxe da Resposta
{
"ClusterMetadata": {
"AddressId": "string",
"ClusterId": "string",
"ClusterState": "string",
"CreationDate": number,
"Description": "string",
"ForwardingAddressId": "string",
"JobType": "string",
"KmsKeyARN": "string",
"Notification": {
"DevicePickupSnsTopicARN": "string",
"JobStatesToNotify": [ "string" ],
"NotifyAll": boolean,
"SnsTopicARN": "string"
},
"OnDeviceServiceConfiguration": {
"EKSOnDeviceService": {
"EKSAnywhereVersion": "string",
"KubernetesVersion": "string"
},
"NFSOnDeviceService": {
"StorageLimit": number,
"StorageUnit": "string"
},
"S3OnDeviceService": {
"FaultTolerance": number,
"ServiceSize": number,
"StorageLimit": number,
"StorageUnit": "string"
},
"TGWOnDeviceService": {
"StorageLimit": number,
"StorageUnit": "string"
}
},
"Resources": {
"Ec2AmiResources": [
{
"AmiId": "string",
"SnowballAmiId": "string"
}
],
"LambdaResources": [
{
"EventTriggers": [
{
"EventResourceARN": "string"
}
],
"LambdaArn": "string"
}
],
"S3Resources": [
{
"BucketArn": "string",
"KeyRange": {
"BeginMarker": "string",
"EndMarker": "string"
},
"TargetOnDeviceServices": [
{
"ServiceName": "string",
"TransferOption": "string"
}
]
}
]
},
"RoleARN": "string",
"ShippingOption": "string",
"SnowballType": "string",
"TaxDocuments": {
"IND": {
"GSTIN": "string"
}
}
}
}
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- ClusterMetadata
-
Retorna informações sobre um cluster específico, incluindo informações de envio, o status do cluster e outros metadados importantes.
Tipo: objeto ClusterMetadata
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- InvalidResourceException
-
Não foi possível encontrar o recurso especificado. Confira as informações fornecidas na última solicitação e tente novamente.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: