ListResourceGroups - : 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	ListResourceGroups	Operação a ser executada. Defina o valor como ListResourceGroups.
ResourceGroupType	Integer	Sim	3	Tipo dos grupos de recursos a consultar. Valores válidos: 0: DataWorks 1: agendamento 2: MaxCompute 3: Platform for AI (PAI) 4: Data Integration 7: grupo de recursos exclusivo para agendamento (um ID é gerado para o recurso adquirido ao comprar esse grupo). 9: DataService Studio Valor padrão: 1 Se o valor indicar um mecanismo de computação, os grupos de recursos consultados serão aqueles criados durante a aquisição desse mecanismo.
Keyword	String	Não	abc	Palavra-chave usada para correspondência aproximada por nome e identificador do grupo de recursos.
BizExtKey	String	Não	default	Categoria dos grupos de recursos. Valores válidos: default: grupo de recursos compartilhado single: grupo de recursos exclusivo Valor padrão: default
ResourceManagerResourceGroupId	String	Não	rg-acfmzbn7pti3zfa	ID do grupo de recursos.
Tags	Array	Não		Tags.
Key	String	Não	Env	Chave da tag.
Value	String	Não	Test	Valor da tag.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
HttpStatusCode	Integer	200	Código de status HTTP retornado.
RequestId	String	0bc1411515937635973****	ID da solicitação. Use este ID para localizar logs e solucionar problemas.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida.
Data	Array of Data		Grupos de recursos.
Status	Integer	0	Status do grupo de recursos. Valores válidos: 0: NORMAL, indica que o grupo de recursos está em execução ou em serviço. 1: STOP, indica que o grupo de recursos expirou e está congelado. 2: DELETED, indica que o grupo de recursos foi liberado ou destruído. 3: CREATING, indica que o grupo de recursos está sendo criado ou iniciado. 4: CREATE_FAILED, indica falha na criação ou inicialização do grupo de recursos. 5: UPDATING, indica que o grupo de recursos está sendo expandido ou atualizado. 6: UPDATE_FAILED, indica falha na expansão ou atualização do grupo de recursos. 7: DELETING, indica que o grupo de recursos está sendo liberado ou destruído. 8: DELETE_FAILED, indica falha na liberação ou destruição do grupo de recursos. 9: TIMEOUT, indica que a operação no grupo de recursos atingiu o tempo limite. Todas as operações podem atingir o tempo limite. Este valor está disponível temporariamente apenas para o DataService Studio.
UpdateTime	String	Jul 9, 2018 2:43:37 PM	Hora da última atualização do grupo de recursos.
IsDefault	Boolean	true	Indica se o grupo de recursos é o padrão. Valores válidos: true: o grupo de recursos é o padrão. false: o grupo de recursos não é o padrão.
Cluster	String	AY18G	Nome do cluster. Este parâmetro é retornado apenas se o tipo do grupo de recursos for MaxCompute ou PAI.
EnableKp	Boolean	false	Indica se o UID de uma conta Alibaba Cloud é usado para acesso. Valores válidos: true: o mecanismo de computação MaxCompute usa o UID da conta Alibaba Cloud como nome de exibição da conta para acesso. false: o mecanismo de computação MaxCompute usa o nome da conta Alibaba Cloud como nome de exibição da conta para acesso. Os demais valores não são aplicáveis. Este parâmetro é retornado apenas se o tipo do grupo de recursos for MaxCompute.
ResourceGroupType	String	3	Tipo do grupo de recursos. Valores válidos: 0: DataWorks 2: MaxCompute 3: PAI 4: Data Integration 7: agendamento 9: DataService Studio
CreateTime	String	Jul 9, 2018 2:43:37 PM	Hora de criação do cluster. Exemplo: Jul 9, 2018 02:43:37 PM.
Identifier	String	e1815577-2f4e-4c5e-b29****	Identificador do grupo de recursos.
Mode	String	SHARE	Modo do grupo de recursos. Valores válidos: ISOLATE: grupo de recursos exclusivo com faturamento por assinatura SHARE: grupo de recursos compartilhado com pagamento conforme o uso DEVELOP: grupo de recursos para desenvolvedores
BizExtKey	String	default	Categoria do grupo de recursos. Valores válidos: default: grupo de recursos compartilhado single: grupo de recursos exclusivo
Sequence	Integer	300	Número de sequência do grupo de recursos. Os grupos criados são classificados em ordem crescente por esse número.
Specs	Map		Detalhes do grupo de recursos. O conteúdo entre chaves {} representa esses detalhes.
Name	String	abc	Nome do grupo de recursos.
Id	Long	1234567	ID do grupo de recursos.
TenantId	Long	1234567	ID do locatário.
ResourceManagerResourceGroupId	String	rg-acfmzbn7pti3zfa	ID do grupo de recursos Alibaba Cloud.
Tags	Array of Tag		Tags.
Key	String	Env	Chave da tag.
Value	String	Test	Valor da tag.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListResourceGroups
&ResourceGroupType=3
&Keyword=abc
&BizExtKey=default
&ResourceManagerResourceGroupId=rg-acfmzbn7pti3zfa
&Tags=[{"Key":"Env","Value":"Test"}]
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<ListResourceGroupsResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <RequestId>0bc1411515937635973****</RequestId>
    <Success>true</Success>
    <Data>
        <Status>0</Status>
        <UpdateTime>Jul 9, 2018 2:43:37 PM</UpdateTime>
        <IsDefault>true</IsDefault>
        <Cluster>AY18G</Cluster>
        <EnableKp>false</EnableKp>
        <ResourceGroupType>3</ResourceGroupType>
        <CreateTime>Jul 9, 2018 2:43:37 PM</CreateTime>
        <Identifier>e1815577-2f4e-4c5e-b29****</Identifier>
        <Mode>SHARE</Mode>
        <BizExtKey>default</BizExtKey>
        <Sequence>300</Sequence>
        <Name>abc</Name>
        <Id>1234567</Id>
        <TenantId>1234567</TenantId>
        <ResourceManagerResourceGroupId>rg-acfmzbn7pti3zfa</ResourceManagerResourceGroupId>
        <Tags>
            <Key>Env</Key>
            <Value>Test</Value>
        </Tags>
    </Data>
</ListResourceGroupsResponse>

Formato JSON

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

{
  "HttpStatusCode" : 200,
  "RequestId" : "0bc1411515937635973****",
  "Success" : true,
  "Data" : [ {
    "Status" : 0,
    "UpdateTime" : "Jul 9, 2018 2:43:37 PM",
    "IsDefault" : true,
    "Cluster" : "AY18G",
    "EnableKp" : false,
    "ResourceGroupType" : "3",
    "CreateTime" : "Jul 9, 2018 2:43:37 PM",
    "Identifier" : "e1815577-2f4e-4c5e-b29****",
    "Mode" : "SHARE",
    "BizExtKey" : "default",
    "Sequence" : 300,
    "Name" : "abc",
    "Id" : 1234567,
    "TenantId" : 1234567,
    "ResourceManagerResourceGroupId" : "rg-acfmzbn7pti3zfa",
    "Tags" : [ {
      "Key" : "Env",
      "Value" : "Test"
    } ]
  } ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.Tenant.ConnectionNotExists	The connection does not exist.	A source de dados especificada não existe.
400	Invalid.Tenant.ProjectNotExists	The project does not exist.	O workspace especificado não existe.
400	Invalid.Tenant.UserNotInProject	The user is not in the project.	O usuário não foi adicionado ao workspace.
403	Invalid.Tenant.UserIsNotProjectOwnerOrAdmin	The user is not a project administrator or owner.	O usuário não é proprietário ou administrador do workspace.
403	Invalid.Tenant.UserNotInTenant	The user is not in tenant.	O usuário não pertence ao locatário.

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