# Visualizar uma concessão
Você pode ver os detalhes de uma concessão de acesso na instância da funcionalidade Concessões de Acesso do S3 usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e os AWS SDKs.
## Usar o console do S3
**Como visualizar os detalhes de uma concessão de acesso**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Access Grants**.
1. Na página **Concessões de Acesso do S3**, escolha a região que contém a instância da funcionalidade Concessões de Acesso do S3 com a qual você deseja trabalhar.
1. Escolha **Visualizar detalhes** da instância.
1. Na página de detalhes, escolha a guia **Concessões**.
1. Na seção **Concessões**, encontre a concessão de acesso que deseja visualizar. Use a caixa de pesquisa para filtrar a lista de concessões.
## Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
Para usar os comandos a seguir, substitua os `{{user input placeholders}}` por suas próprias informações.
**Example : visualizar os detalhes de uma concessão de acesso**
```
aws s3control get-access-grant \
--account-id {{111122223333}} \
--access-grant-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE22222}}
```
Resposta:
```
{
"CreatedAt": "{{2023-05-31T18:41:34.663000+00:00}}",
"AccessGrantId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE22222}}",
"AccessGrantArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant-{{a1b2c3d4-5678-90ab-cdef-EXAMPLE22222}}",
"Grantee": {
"GranteeType": "{{IAM}}",
"GranteeIdentifier": "arn:aws:iam::{{111122223333}}:user/{{data-consumer-3}}"
},
"Permission": "{{READ}}",
"AccessGrantsLocationId": "{{12a6710f-5af8-41f5-b035-0bc795bf1a2b}}",
"AccessGrantsLocationConfiguration": {
"S3SubPrefix": "{{prefixB*}}"
},
"GrantScope": "s3://{{amzn-s3-demo-bucket}}/"
}
```
**Example : listar todas as concessões de acesso em uma instância da funcionalidade Concessões de Acesso do S3**
Opcionalmente, você pode usar os seguintes parâmetros para restringir os resultados a um prefixo do S3 ou a uma identidade do AWS Identity and Access Management (IAM):
+ **Subprefixo** – `--grant-scope s3://{{bucket-name/prefix*}}`
+ **Identidade do IAM**: `--grantee-type IAM` e `--grantee-identifier arn:aws:iam::{{123456789000}}:role/{{accessGrantsConsumerRole}}`
```
aws s3control list-access-grants \
--account-id {{111122223333}}
```
Resposta:
```
{
"AccessGrantsList": [{"CreatedAt": "{{2023-06-14T17:54:46.542000+00:00}}",
"AccessGrantId": "{{dd8dd089-b224-4d82-95f6-975b4185bbaa}}",
"AccessGrantArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant/{{dd8dd089-b224-4d82-95f6-975b4185bbaa}}",
"Grantee": {
"GranteeType": "{{IAM}}",
"GranteeIdentifier": "arn:aws:iam::{{111122223333}}:user/{{data-consumer-3}}"
},
"Permission": "{{READ}}",
"AccessGrantsLocationId": "{{23514a34-ea2e-4ddf-b425-d0d4bfcarda1}}",
"GrantScope": "s3://{{amzn-s3-demo-bucket}}/{{prefixA*}}"
},
{"CreatedAt": "{{2023-06-24T17:54:46.542000+00:00}}",
"AccessGrantId": "{{ee8ee089-b224-4d72-85f6-975b4185a1b2}}",
"AccessGrantArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant/{{ee8ee089-b224-4d72-85f6-975b4185a1b2}}",
"Grantee": {
"GranteeType": "{{IAM}}",
"GranteeIdentifier": "arn:aws:iam::{{111122223333}}:user/{{data-consumer-9}}"
},
"Permission": "{{READ}}",
"AccessGrantsLocationId": "{{12414a34-ea2e-4ddf-b425-d0d4bfcacao0}}",
"GrantScope": "s3://{{amzn-s3-demo-bucket/prefixB*}}"
},
]
}
```
## Uso da API REST
Você pode usar as operações de API do Amazon S3 para visualizar os detalhes de uma concessão de acesso e listar todas as concessões de acesso em uma instância da funcionalidade Concessões de Acesso do S3. Para obter informações sobre o suporte à API REST para gerenciar concessões de acesso, consulte as seguintes seções na *Referência da API do Amazon Simple Storage Service*:
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrant.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrant.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrants.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrants.html)
## Usar SDKs da AWS
Esta seção fornece exemplos de como obter os detalhes de uma concessão de acesso usando os AWS SDKs.
Para usar os exemplos a seguir, substitua `{{user input placeholders}}` por suas próprias informações.
------
#### [ Java ]
**Example : visualizar os detalhes de uma concessão de acesso**
```
public void getAccessGrant() {
GetAccessGrantRequest getRequest = GetAccessGrantRequest.builder()
.accountId("{{111122223333}}")
.accessGrantId("{{a1b2c3d4-5678-90ab-cdef-EXAMPLE22222}}")
.build();
GetAccessGrantResponse getResponse = s3Control.getAccessGrant(getRequest);
LOGGER.info("GetAccessGrantResponse: " + getResponse);
}
```
Resposta:
```
GetAccessGrantResponse(
CreatedAt={{2023-06-07T05:20:26.330Z}},
AccessGrantId={{a1b2c3d4-5678-90ab-cdef-EXAMPLE22222}},
AccessGrantArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant-{{fd3a5086-42f7-4b34-9fad-472e2942c70e}},
Grantee=Grantee(
GranteeType={{IAM}},
GranteeIdentifier=arn:aws:iam::{{111122223333}}:user/{{data-consumer-3}}
),
Permission={{READ}},
AccessGrantsLocationId={{12a6710f-5af8-41f5-b035-0bc795bf1a2b}},
AccessGrantsLocationConfiguration=AccessGrantsLocationConfiguration(
S3SubPrefix={{prefixB*}}
),
GrantScope=s3://{{amzn-s3-demo-bucket/}}
)
```
**Example : listar todas as concessões de acesso em uma instância da funcionalidade Concessões de Acesso do S3**
Opcionalmente, você pode usar os seguintes parâmetros para restringir os resultados a um prefixo do S3 ou a uma identidade do IAM:
+ **Escopo** – `GrantScope=s3://{{bucket-name/prefix*}}`
+ **Beneficiário**: `GranteeType=IAM` e `GranteeIdentifier= arn:aws:iam::{{{{111122223333}}}}:role/{{accessGrantsConsumerRole}}`
```
public void listAccessGrants() {
ListAccessGrantsRequest listRequest = ListAccessGrantsRequest.builder()
.accountId("{{111122223333}}")
.build();
ListAccessGrantsResponse listResponse = s3Control.listAccessGrants(listRequest);
LOGGER.info("ListAccessGrantsResponse: " + listResponse);
}
```
Resposta:
```
ListAccessGrantsResponse(
AccessGrantsList=[
ListAccessGrantEntry(
CreatedAt={{2023-06-14T17:54:46.540z}},
AccessGrantId={{dd8dd089-b224-4d82-95f6-975b4185bbaa}},
AccessGrantArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant/{{dd8dd089-b224-4d82-95f6-975b4185bbaa}},
Grantee=Grantee(
GranteeType={{IAM}}, GranteeIdentifier= arn:aws:iam::{{111122223333}}:user/{{data-consumer-3}}
),
Permission={{READ}},
AccessGrantsLocationId={{23514a34-ea2e-4ddf-b425-d0d4bfcarda1}},
GrantScope=s3://{{amzn-s3-demo-bucket/prefixA}}
),
ListAccessGrantEntry(
CreatedAt={{2023-06-24T17:54:46.540Z}},
AccessGrantId={{ee8ee089-b224-4d72-85f6-975b4185a1b2}},
AccessGrantArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/grant/{{ee8ee089-b224-4d72-85f6-975b4185a1b2}},
Grantee=Grantee(
GranteeType={{IAM}}, GranteeIdentifier= arn:aws:iam::{{111122223333}}:user/{{data-consumer-9}}
),
Permission={{READ}},
AccessGrantsLocationId={{12414a34-ea2e-4ddf-b425-d0d4bfcacao0}},
GrantScope=s3://{{amzn-s3-demo-bucket/prefixB*}}
)
]
)
```
------