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á.
Essa ação retorna detalhes de uma retenção legal especificada. Os detalhes são o corpo de uma retenção legal no formato JSON, além dos metadados.
Sintaxe da Solicitação
GET /legal-holds/legalHoldId/ HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- legalHoldId
-
O ID da retenção legal.
Obrigatório: sim
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"CancelDescription": "string",
"CancellationDate": number,
"CreationDate": number,
"Description": "string",
"LegalHoldArn": "string",
"LegalHoldId": "string",
"RecoveryPointSelection": {
"DateRange": {
"FromDate": number,
"ToDate": number
},
"ResourceIdentifiers": [ "string" ],
"VaultNames": [ "string" ]
},
"RetainRecordUntil": number,
"Status": "string",
"Title": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- CancelDescription
-
O motivo da remoção da retenção legal.
Tipo: string
- CancellationDate
-
Hora em formato numérico em que a retenção legal foi cancelada.
Tipo: carimbo de data/hora
- CreationDate
-
A hora em que a retenção legal foi criada.
Tipo: carimbo de data/hora
- Description
-
A descrição da string da retenção legal.
Tipo: string
- LegalHoldArn
-
O ARN do framework da retenção legal especificada. O formato do ARN depende do tipo de recurso.
Tipo: string
- LegalHoldId
-
O ID da retenção legal.
Tipo: string
- RecoveryPointSelection
-
Os critérios para atribuir um conjunto de recursos, como tipos de recursos ou cofres de backup.
Tipo: objeto RecoveryPointSelection
- RetainRecordUntil
-
A data e a hora até as quais o registro da retenção legal será retido.
Tipo: carimbo de data/hora
- Status
-
O status da retenção legal.
Tipo: string
Valores Válidos:
CREATING | ACTIVE | CANCELING | CANCELED - Title
-
O título da retenção legal.
Tipo: string
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- InvalidParameterValueException
-
Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.
Código de status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
Código de status HTTP: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
Código de status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
