ListDedicatedCluster - Data Transmission Service: 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 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	ListDedicatedCluster	Operação a ser executada. Defina o valor como ListDedicatedCluster.
RegionId	String	No	cn-hangzhou	ID da região.
Type	String	No	NAME	Tipo da condição de consulta. Valores válidos: NAME: nome do cluster. INSTANCE: ID de uma instância de cluster. DEDICATEDCLUSTERID: ID do cluster dedicado. Nota Especifique Params para definir o conteúdo da condição de consulta.
Params	String	No	dtspk3f13r731m****	Conteúdo da condição de consulta. Nota Especifique Type para definir o tipo da condição de consulta.
State	String	No	init	Status do cluster. Valores válidos: init: cluster em inicialização. schedule: cluster aguardando agendamento. running: cluster em execução. upgrade: cluster em atualização. downgrade: cluster em redução de configuração. locked: cluster bloqueado. releasing: cluster em liberação. released: cluster liberado.
OrderDirection	String	No	asc	Ordem de classificação dos registros retornados. Valores válidos: asc (padrão): classifica os registros em ordem crescente. desc: classifica os registros em ordem decrescente.
OrderColumn	String	No	gmtCreated	Critério de ordenação dos registros quando a resposta contém múltiplos clusters dedicados do Data Transmission Service (DTS). Valores válidos: gmtCreated: momento de criação do cluster. orderCount: quantidade de nós no cluster.
PageSize	Integer	No	10	Quantidade de registros por página.
PageNumber	Integer	No	1	Número da página. O valor deve ser um número inteiro maior que 0. Valor padrão: 1.

Parâmetros de resposta

Parameter	Type	Example	Description
HttpStatusCode	String	200	Código de status HTTP.
RequestId	String	621BB4F8-3016-4FAA-8D5A-5D3163CC****	ID da solicitação.
ErrCode	String	InternalError	Código de erro retornado se a solicitação falhar.
Success	String	true	Indica se a solicitação foi bem-sucedida.
ErrMessage	String	The Value of Input Parameter %s is not valid.	Mensagem de erro retornada se a solicitação falhar.
PageRecordCount	Integer	20	Quantidade de registros por página.
TotalRecordCount	Integer	15	Total de clusters que atendem à condição de consulta.
PageNumber	Integer	1	Número da página. O valor deve ser um número inteiro maior que 0. Valor padrão: 1.
DedicatedClusterStatusList	Array of DedicatedClusterStatus		Status de todos os clusters.
DedicatedClusterStatus
DtsInstanceID	String	dtsi03e3zty16i****	ID da instância DTS.
DedicatedClusterId	String	dtscluster*******	ID do cluster.
DedicatedClusterName	String	daily_test	Nome do cluster.
Du	Long	30	Quantidade de unidades DTS (DUs).
OversoldDu	Long	60	Quantidade de DUs com overcommit.
UsedDu	Long	5	Quantidade de DUs utilizadas.
State	String	init	Status do cluster. Valores válidos: init: cluster em inicialização. schedule: cluster aguardando agendamento. running: cluster em execução. upgrade: cluster em atualização. downgrade: cluster em redução de configuração. locked: cluster bloqueado. releasing: cluster em liberação. released: cluster liberado.
RegionId	String	cn-hangzhou	ID da região onde a instância DTS está localizada.
GmtCreated	Long	1647424384606	Momento de criação do cluster.
NodeCount	Long	5	Quantidade de nós no cluster.
DuUtilization	Long	16.6667	Utilização de DU. Unidade: %.
CpuUtilization	Long	30	Utilização de cpu. Unidade: %.
TotalCpuCore	Long	100	Total de núcleos de cpu.
UsedCpuCore	Long	30	Quantidade de núcleos de cpu utilizados.
MemUtilization	Long	20	Utilização de memória.
TotalMemGBSize	Long	256	Tamanho total da memória. Unidade: GB.
UsedMemGBSize	Long	128	Tamanho da memória utilizada. Unidade: GB.
DiskUtilization	Long	50	Utilização de disco.
TotalDiskGBSize	Long	2048	Tamanho total do disco. Unidade: GB.
UsedDiskGBSize	Long	1024	Tamanho do disco utilizado. Unidade: GB.

Exemplos

Exemplo de solicitação

http(s)://dts.aliyuncs.com/?Action=ListDedicatedCluster
&RegionId=cn-hangzhou
&Type=NAME
&Params=dtspk3f13r731m****
&State=init
&OrderDirection=asc
&OrderColumn=gmtCreated
&PageSize=10
&PageNumber=1
&Common request parameters

Exemplo de resposta de sucesso

Formato XML

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

<ListDedicatedClusterResponse>
    <code>200</code>
    <data>
        <TotalRecordCount>2</TotalRecordCount>
        <PageRecordCount>20</PageRecordCount>
        <RequestId>49BCBE1F-3AB4-***</RequestId>
        <PageNumber>1</PageNumber>
        <DedicatedClusterStatusList>
            <DedicatedClusterStatus>
                <UsedDu>14</UsedDu>
                <DuUtilization>46</DuUtilization>
                <DedicatedClusterId>dtscluster_***</DedicatedClusterId>
                <NodeCount>2</NodeCount>
                <UsedDiskGBSize>51</UsedDiskGBSize>
                <OversoldDu>30</OversoldDu>
                <TotalDiskGBSize>1006</TotalDiskGBSize>
                <DiskUtilization>6</DiskUtilization>
                <UsedMemGBSize>63</UsedMemGBSize>
                <GmtCreated>1642476144000</GmtCreated>
                <DtsInstanceID>dtsb84w12e2188ya1r</DtsInstanceID>
                <DedicatedClusterName>dtscluster_***</DedicatedClusterName>
                <TotalMemGBSize>259</TotalMemGBSize>
                <Du>30</Du>
                <MemUtilization>24</MemUtilization>
                <State>running</State>
                <UsedCpuCore>0</UsedCpuCore>
                <TotalCpuCore>32</TotalCpuCore>
                <RegionId>cn-hangzhou</RegionId>
                <CpuUtilization>2</CpuUtilization>
            </DedicatedClusterStatus>
            <DedicatedClusterStatus>
                <UsedDu>0</UsedDu>
                <DuUtilization>0</DuUtilization>
                <DedicatedClusterId>dtsCluster***</DedicatedClusterId>
                <NodeCount>0</NodeCount>
                <UsedDiskGBSize>0</UsedDiskGBSize>
                <OversoldDu>60</OversoldDu>
                <TotalDiskGBSize>0</TotalDiskGBSize>
                <DiskUtilization>0</DiskUtilization>
                <UsedMemGBSize>0</UsedMemGBSize>
                <GmtCreated>1641377381000</GmtCreated>
                <DedicatedClusterName>dedicatedCluster_***</DedicatedClusterName>
                <TotalMemGBSize>0</TotalMemGBSize>
                <Du>40</Du>
                <MemUtilization>0</MemUtilization>
                <State>releasing</State>
                <UsedCpuCore>0</UsedCpuCore>
                <TotalCpuCore>0</TotalCpuCore>
                <RegionId>cn-hangzhou</RegionId>
                <CpuUtilization>0</CpuUtilization>
            </DedicatedClusterStatus>
        </DedicatedClusterStatusList>
        <HttpStatusCode>200</HttpStatusCode>
        <Success>true</Success>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>49BCBE1F-3AB4-****</requestId>
    <successResponse>true</successResponse>
</ListDedicatedClusterResponse>

Formato JSON

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

{
  "code" : "200",
  "data" : {
    "TotalRecordCount" : 2,
    "PageRecordCount" : 20,
    "RequestId" : "49BCBE1F-3AB4-***",
    "PageNumber" : 1,
    "DedicatedClusterStatusList" : {
      "DedicatedClusterStatus" : [ {
        "UsedDu" : 14,
        "DuUtilization" : 46,
        "DedicatedClusterId" : "dtscluster_***",
        "NodeCount" : 2,
        "UsedDiskGBSize" : 51,
        "OversoldDu" : 30,
        "TotalDiskGBSize" : 1006,
        "DiskUtilization" : 6,
        "UsedMemGBSize" : 63,
        "GmtCreated" : 1642476144000,
        "DtsInstanceID" : "dtsb84w12e2188ya1r",
        "DedicatedClusterName" : "dtscluster_***",
        "TotalMemGBSize" : 259,
        "Du" : 30,
        "MemUtilization" : 24,
        "State" : "running",
        "UsedCpuCore" : 0,
        "TotalCpuCore" : 32,
        "RegionId" : "cn-hangzhou",
        "CpuUtilization" : 2
      }, {
        "UsedDu" : 0,
        "DuUtilization" : 0,
        "DedicatedClusterId" : "dtsCluster***",
        "NodeCount" : 0,
        "UsedDiskGBSize" : 0,
        "OversoldDu" : 60,
        "TotalDiskGBSize" : 0,
        "DiskUtilization" : 0,
        "UsedMemGBSize" : 0,
        "GmtCreated" : 1641377381000,
        "DedicatedClusterName" : "dedicatedCluster_***",
        "TotalMemGBSize" : 0,
        "Du" : 40,
        "MemUtilization" : 0,
        "State" : "releasing",
        "UsedCpuCore" : 0,
        "TotalCpuCore" : 0,
        "RegionId" : "cn-hangzhou",
        "CpuUtilization" : 0
      } ]
    },
    "HttpStatusCode" : 200,
    "Success" : true
  },
  "httpStatusCode" : "200",
  "requestId" : "49BCBE1F-3AB4-****",
  "successResponse" : true
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	Throttling.User	Request was denied due to user flow control.	A quantidade de solicitações atingiu o limite e a solicitação foi rejeitada. Tente novamente mais tarde.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	A resposta do servidor expirou ou o servidor estava indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	A assinatura expirou. Utilize uma nova assinatura.

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