DescribeACLAttribute - : 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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeACLAttribute	Operação a ser executada. Defina o valor como DescribeACLAttribute.
RegionId	String	No	cn-hangzhou	ID da região onde a ACL está implantada.
AclId	String	No	acl-ohlexqptfhyaq****	ID da ACL.
PageSize	Integer	No	10	Número de entradas a retornar por página. Valores válidos: 1 a 50. Valor padrão: 10.
PageNumber	Integer	No	1	Número da página a retornar. Valor padrão: 1.
Direction	String	No	out	Direção do tráfego ao qual a regra de ACL se aplica. Valores válidos: in: a regra controla o tráfego de entrada da rede local associada à instância do Smart Access Gateway (SAG). out: a regra controla o tráfego de saída da rede local associada à instância do SAG.
Order	String	No	1255444444	ID do pedido.
Name	String	No	doctest	Nome da ACL. Deve ter de 2 a 100 caracteres, podendo conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). É obrigatório começar com uma letra. Nota Este parâmetro aceita correspondência aproximada.

Parâmetros de resposta

Parameter	Type	Example	Description
TotalCount	Integer	3	Total de entradas retornadas.
PageSize	Integer	10	Quantidade de entradas por página.
RequestId	String	8F62CE77-FBA2-4F8D-AED9-0A02814EDA69	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
Acrs	Array of Acr		Informações sobre as regras da ACL.
Acr
Direction	String	out	Direção do tráfego ao qual a regra de ACL se aplica. in: a regra controla o tráfego de entrada da rede local associada à instância do SAG. out: a regra controla o tráfego de saída da rede local associada à instância do SAG.
Type	String	WAN	Tipo da regra de ACL: LAN: controla o tráfego transmitido por endereços IP privados. WAN: controla o tráfego transmitido por endereços IP públicos.
DpiSignatureIds	Array of String	1	IDs dos aplicativos correspondentes à regra de ACL atual. Use a operação ListDpiSignatures para consultar os IDs e detalhes dos aplicativos.
IpProtocol	String	UDP	Protocolo usado pela regra de ACL. Os protocolos listados neste tópico servem apenas como referência; prevalecem aqueles exibidos no console do SAG. O valor não diferencia maiúsculas de minúsculas.
Priority	Integer	70	Prioridade da regra de ACL. Valores válidos: 1 a 100.
AclId	String	acl-7louazbja80bmg****	ID da ACL.
Policy	String	drop	Ação da regra de ACL. Valores válidos: accept: permite o tráfego de rede. drop: bloqueia o tráfego de rede.
Description	String	ACLRule	Descrição da regra de ACL. Deve ter de 1 a 512 caracteres. Por padrão, este parâmetro não é retornado. Para incluí-lo na resposta, use a operação ModifyACLRule e adicione uma descrição à regra.
GmtCreate	Long	1580821597000	Timestamp de criação da regra de ACL. Campo do tipo Long. Se houver múltiplas regras com a mesma prioridade, prevalece aquela com o timestamp mais antigo.
DestCidr	String	0.0.0.0/0	Bloco CIDR de destino. Especificado em notação CIDR. Exemplo: 192.168.10.0/24.
DestPortRange	String	10000/20000	Intervalo de portas de destino. Valores válidos: 1 a 65535 e -1. Formatos aceitos: 1/200 ou 80/80. O valor -1/-1 representa todas as portas.
Name	String	doctest	Nome da ACL. Deve ter de 2 a 100 caracteres, podendo conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). É obrigatório começar com uma letra.
AcrId	String	acr-gxzxj5w9qqdf1c****	ID da regra de ACL.
SourceCidr	String	0.0.0.0/0	Bloco CIDR de source. Especificado em notação CIDR. Exemplo: 192.168.1.0/24.
SourcePortRange	String	30000/40000	Intervalo de portas de source. Valores válidos: 1 a 65535 e -1. Formatos aceitos: 1/200 ou 80/80. O valor -1/-1 representa todas as portas.
DpiGroupIds	Array of String	20	IDs dos grupos de aplicativos correspondentes à regra de ACL atual. Use a operação ListDpiGroups para consultar os IDs e detalhes dos grupos de aplicativos.
AclType	String	acl-hardware	Tipo de 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=DescribeACLAttribute
&RegionId=cn-hangzhou
&AclId=acl-ohlexqptfhyaq****
&PageSize=10
&PageNumber=1
&Direction=out
&Order=1255444444
&Name=doctest
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DescribeACLAttributeResponse>
    <TotalCount>3</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>8F62CE77-FBA2-4F8D-AED9-0A02814EDA69</RequestId>
    <PageNumber>1</PageNumber>
    <Acrs>
        <Direction>out</Direction>
        <Type>WAN</Type>
        <DpiSignatureIds>1</DpiSignatureIds>
        <IpProtocol>UDP</IpProtocol>
        <Priority>70</Priority>
        <AclId>acl-7louazbja80bmg****</AclId>
        <Policy>drop</Policy>
        <Description>ACLRule</Description>
        <GmtCreate>1580821597000</GmtCreate>
        <DestCidr>0.0.0.0/0</DestCidr>
        <DestPortRange>10000/20000</DestPortRange>
        <Name>doctest</Name>
        <AcrId>acr-gxzxj5w9qqdf1c****</AcrId>
        <SourceCidr>0.0.0.0/0</SourceCidr>
        <SourcePortRange>30000/40000</SourcePortRange>
        <DpiGroupIds>20</DpiGroupIds>
        <AclType>acl-hardware</AclType>
    </Acrs>
</DescribeACLAttributeResponse>

Formato JSON

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

{
  "TotalCount" : 3,
  "PageSize" : 10,
  "RequestId" : "8F62CE77-FBA2-4F8D-AED9-0A02814EDA69",
  "PageNumber" : 1,
  "Acrs" : [ {
    "Direction" : "out",
    "Type" : "WAN",
    "DpiSignatureIds" : [ "1" ],
    "IpProtocol" : "UDP",
    "Priority" : 70,
    "AclId" : "acl-7louazbja80bmg****",
    "Policy" : "drop",
    "Description" : "ACLRule",
    "GmtCreate" : 1580821597000,
    "DestCidr" : "0.0.0.0/0",
    "DestPortRange" : "10000/20000",
    "Name" : "doctest",
    "AcrId" : "acr-gxzxj5w9qqdf1c****",
    "SourceCidr" : "0.0.0.0/0",
    "SourcePortRange" : "30000/40000",
    "DpiGroupIds" : [ "20" ],
    "AclType" : "acl-hardware"
  } ]
}

Códigos de erro

HttpCode	Error code	Error message	Description
403	Forbidden	User not authorized to operate on the specified resource.	Erro retornado quando o usuário não tem permissão para gerencie 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 valor inválido.
403	InvalidId.ACL	The specified ACL ID is invalid.	Erro retornado quando o ID da ACL especificado é 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.