DescribeACLs - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeACLs	Operação a ser executada. Defina o valor como DescribeACLs.
RegionId	String	Sim	cn-shanghai	ID da região onde a ACL está implantada.
AclIds	String	Não	acl-xhwhyuo43l*******	ID da ACL. Para consultar várias ACLs simultaneamente, separe os IDs por vírgulas (,). Se este parâmetro não for definido, todas as ACLs na região especificada serão consultadas.
Name	String	Não	test	Nome da ACL. O nome deve ter de 2 a 100 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra.
PageSize	Integer	Não	10	Número de entradas a retornar por página. Valor máximo: 50. Valor padrão: 10.
PageNumber	Integer	Não	1	Número da página a retornar. Valor padrão: 1.
AclType	String	Não	acl-hardware	Tipo da instância SAG associada à ACL. Valores válidos: acl-hardware: instância SAG CPE acl-software: instância do aplicativo SAG

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalCount	Integer	1	Número total de entradas retornadas.
PageSize	Integer	10	Número de entradas retornadas por página.
RequestId	String	660F303F-C88E-4026-BC6A-FC24B78FD7EA	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
Acls	Array of Acl		Lista de ACLs.
Acl
SagCount	String	0	Número de instâncias SAG associadas à ACL.
AclId	String	acl-xhwhyuo43l*******	ID da ACL.
Name	String	test	Nome da ACL.
ResourceGroupId	String	rg-acfm2iu4fnc****	ID do grupo de recursos ao qual a ACL pertence.
AclType	String	acl-hardware	Tipo da instância SAG associada à ACL. Valores válidos: acl-hardware: instância SAG CPE acl-software: instância do aplicativo SAG

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeACLs
&RegionId=cn-shanghai
&AclIds=acl-xhwhyuo43l*******
&Name=test
&PageSize=10
&PageNumber=1
&AclType=acl-hardware
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeACLsResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>660F303F-C88E-4026-BC6A-FC24B78FD7EA</RequestId>
    <PageNumber>1</PageNumber>
    <Acls>
        <SagCount>0</SagCount>
        <AclId>acl-xhwhyuo43l*******</AclId>
        <Name>test</Name>
        <ResourceGroupId>rg-acfm2iu4fnc****</ResourceGroupId>
        <AclType>acl-hardware</AclType>
    </Acls>
</DescribeACLsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "660F303F-C88E-4026-BC6A-FC24B78FD7EA",
  "PageNumber" : 1,
  "Acls" : [ {
    "SagCount" : "0",
    "AclId" : "acl-xhwhyuo43l*******",
    "Name" : "test",
    "ResourceGroupId" : "rg-acfm2iu4fnc****",
    "AclType" : "acl-hardware"
  } ]
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
403	Forbidden	User not authorized to operate on the specified resource.	Erro retornado quando o usuário não tem permissão para gerenciar o recurso especificado.
403	MissingParameter	The input parameter is missing, please check your input.	Erro retornado quando um ou mais parâmetros obrigatórios estão vazios. Verifique se todos os parâmetros necessários foram configurados.
403	InvalidParameter	The specified parameter is invalid.	Erro retornado quando um parâmetro possui um valor inválido.
403	InternalError	An internal server error occurred.	Erro interno do servidor.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.