Consulta informações de uma ou mais origens de migração.
Notas de uso
Você pode especificar vários parâmetros de solicitação para consulta. O sistema avalia os parâmetros informados com o operador AND. Somente os parâmetros definidos funcionam como condições de filtro.
Parâmetros da solicitação
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DescribeSourceServers | A operação a ser executada. Defina o valor como DescribeSourceServers. |
| JobId | String | No | j-bp19vlwm0tyigbmj**** | O ID do trabalho de migração. |
| State | String | No | Available | O estado da origem de migração. Valores válidos:
|
| Name | String | No | testSourceServerName | O nome da origem de migração. O nome deve ter entre 2 e 128 caracteres, começar com uma letra e não pode iniciar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) e hifens (-). Valor padrão: null. |
| PageNumber | Integer | No | 1 | O número da página. A numeração começa em 1. Valor padrão: 1. |
| PageSize | Integer | No | 10 | A quantidade de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10. |
| SourceId.N | String | No | s-bp1e2fsl57knvuug**** | O ID da origem de migração. Você pode especificar vários IDs. |
| ResourceGroupId | String | No | rg-acfmw3ty5y7**** | O ID do grupo de recursos. |
| Tag.N.Key | String | No | TestKey | A chave da tag N adicionada ao recurso SMC. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não pode começar com acs: ou aliyun. Não pode conter http:// ou https://. |
| Tag.N.Value | String | No | TestValue | O valor da tag N adicionada ao recurso SMC. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 64 caracteres e não pode conter http:// ou https://. |
Parâmetros de resposta
| Parameter | Type | Example | Description |
| SourceServers | Array of SourceServer | As origens de migração consultadas. | |
| SourceServer | |||
| CreationTime | String | 2019-06-27T02:58:09Z | A hora de criação da origem de migração. |
| HeartbeatRate | Integer | 30 | O intervalo de envio de heartbeats pelo cliente SMC. Unidade: segundos. |
| State | String | InUse | O estado da origem de migração. |
| DataDisks | Array of DataDisk | Os discos de dados na origem de migração. | |
| DataDisk | |||
| Index | Integer | 1 | O número de índice do disco de dados. |
| Size | Integer | 20 | O tamanho do disco de dados. Unidade: GiB. |
| Parts | Array of Part | As partições do disco de dados. | |
| Part | |||
| CanBlock | Boolean | false | Indica se a replicação em bloco está ativada para a partição do disco de dados. |
| SizeBytes | Long | 21474836480 | O tamanho da partição do disco de dados. Unidade: bytes. |
| Need | Boolean | false | Indica se a seleção da partição do disco de dados é obrigatória. |
| Device | String | 1_0 | O ID do dispositivo da partição do disco de dados. |
| Path | String | /home/data | O caminho da partição do disco de dados. |
| Path | String | /home/data | O caminho do disco de dados. |
| SystemDiskParts | Array of SystemDiskPart | As partições do disco do sistema. | |
| SystemDiskPart | |||
| CanBlock | Boolean | true | Indica se a replicação em bloco está ativada para a partição do disco do sistema. |
| SizeBytes | Long | 254803968 | O tamanho da partição do disco do sistema. Unidade: bytes. |
| Need | Boolean | true | Indica se a seleção da partição do disco do sistema é obrigatória. |
| Device | String | 0_0 | O ID do dispositivo da partição do disco do sistema. |
| Path | String | /boot | O caminho da partição do disco do sistema. |
| KernelLevel | Integer | 1 | O nível do kernel da origem de migração. |
| SourceId | String | s-bp1e2fsl57knvuug**** | O ID da origem de migração. |
| AgentVersion | String | 1.5.2.3 | A versão do cliente SMC. |
| StatusInfo | String | {"error_code": "S1", "error_msg": "Rsync not found. Please install rsync."} | As informações de status da origem de migração. Este parâmetro é retornado quando a origem de migração está no estado Unavailable. O valor consiste em pares chave-valor no formato JSON. Exemplos de chaves: |
| SystemDiskSize | Integer | 40 | O tamanho do disco do sistema da origem de migração. Unidade: GiB. |
| Description | String | Server Source Imported By GotoAliyun. | A descrição da origem de migração. |
| ErrorCode | String | SourceServer.Offline | O código de erro da origem de migração. |
| JobId | String | j-bp19vlwm0tyigbmj**** | O ID do último trabalho de migração. |
| Platform | String | OpenSUSE | O sistema operacional da origem de migração. |
| ReplicationDriver | String | SMT | O driver de replicação usado na migração. Valor padrão: SMT. |
| Name | String | SourceServerName | O nome da origem de migração. |
| SystemInfo | String | {\"agent_mode\":\"daemon\",\"agent_type\":\"aliyun\",\"client_type\":\"\",\"cores\":\"2\",\"cpu_usage\":\"0.00\",\"hostname\":\"ixxxxxxxxxx\",\"ipv4\":\"10.0.0.1\",\"memory\":\"8.00\",\"memory_usage\":\"3.61\"} | As informações do sistema da origem de migração. O valor consiste em pares chave-valor no formato JSON. Os pares são extensíveis e possuem chaves fixas. A string JSON não ultrapassa 1 KB de tamanho. Exemplos de chaves: |
| Architecture | String | x86_64 | A arquitetura do sistema da origem de migração. |
| ResourceGroupId | String | rg-acfmw3ty5y7**** | O ID do grupo de recursos. |
| Tags | Array of Tag | As tags. | |
| Tag | |||
| Key | String | TestKey | A chave da tag N adicionada ao recurso SMC. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não pode começar com acs: ou aliyun. Não pode conter http:// ou https://. |
| Value | String | TestValue | O valor da tag N adicionada ao recurso SMC. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 64 caracteres e não pode conter http:// ou https://. |
| TotalCount | Integer | 1 | O número total de origens de migração retornadas. |
| PageSize | Integer | 10 | A quantidade de entradas por página. |
| RequestId | String | 410E6073-66D0-45D3-AB3E-4DC3F5E4**** | O ID da solicitação. |
| PageNumber | Integer | 1 | O número da página. |
Exemplos
Exemplos de solicitações
http(s)://smc.aliyuncs.com/?Action=DescribeSourceServers
&JobId=j-bp19vlwm0tyigbmj****
&State=Available
&Name=testSourceServerName
&PageNumber=1
&PageSize=10
&SourceId=["s-bp1e2fsl57knvuug****"]
&ResourceGroupId=rg-acfmw3ty5y7****
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&Common request parameters
Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeSourceServersResponse>
<SourceServers>
<CreationTime>2019-06-27T02:58:09Z</CreationTime>
<HeartbeatRate>30</HeartbeatRate>
<State>InUse</State>
<DataDisks>
<Index>1</Index>
<Size>20</Size>
<Parts>
<CanBlock>false</CanBlock>
<SizeBytes>21474836480</SizeBytes>
<Need>false</Need>
<Device>1_0</Device>
<Path>/home/data</Path>
</Parts>
<Path>/home/data</Path>
</DataDisks>
<SystemDiskParts>
<CanBlock>true</CanBlock>
<SizeBytes>254803968</SizeBytes>
<Need>true</Need>
<Device>0_0</Device>
<Path>/boot</Path>
</SystemDiskParts>
<KernelLevel>1</KernelLevel>
<SourceId>s-bp1e2fsl57knvuug****</SourceId>
<AgentVersion>1.5.2.3</AgentVersion>
<StatusInfo>{"error_code": "S1", "error_msg": "Rsync not found. Please install rsync."}</StatusInfo>
<SystemDiskSize>40</SystemDiskSize>
<Description>Server Source Imported By GotoAliyun.</Description>
<ErrorCode>SourceServer.Offline</ErrorCode>
<JobId>j-bp19vlwm0tyigbmj****</JobId>
<Platform>OpenSUSE</Platform>
<ReplicationDriver>SMT</ReplicationDriver>
<Name>SourceServerName</Name>
<SystemInfo>{\"agent_mode\":\"daemon\",\"agent_type\":\"aliyun\",\"client_type\":\"\",\"cores\":\"2\",\"cpu_usage\":\"0.00\",\"hostname\":\"ixxxxxxxxxx\",\"ipv4\":\"10.0.0.1\",\"memory\":\"8.00\",\"memory_usage\":\"3.61\"}</SystemInfo>
<Architecture>x86_64</Architecture>
<ResourceGroupId>rg-acfmw3ty5y7****</ResourceGroupId>
<Tags>
<Key>TestKey</Key>
<Value>TestValue</Value>
</Tags>
</SourceServers>
<TotalCount>1</TotalCount>
<PageSize>10</PageSize>
<RequestId>410E6073-66D0-45D3-AB3E-4DC3F5E4****</RequestId>
<PageNumber>1</PageNumber>
</DescribeSourceServersResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"SourceServers" : [ {
"CreationTime" : "2019-06-27T02:58:09Z",
"HeartbeatRate" : 30,
"State" : "InUse",
"DataDisks" : [ {
"Index" : 1,
"Size" : 20,
"Parts" : [ {
"CanBlock" : false,
"SizeBytes" : 21474836480,
"Need" : false,
"Device" : "1_0",
"Path" : "/home/data"
} ],
"Path" : "/home/data"
} ],
"SystemDiskParts" : [ {
"CanBlock" : true,
"SizeBytes" : 254803968,
"Need" : true,
"Device" : "0_0",
"Path" : "/boot"
} ],
"KernelLevel" : 1,
"SourceId" : "s-bp1e2fsl57knvuug****",
"AgentVersion" : "1.5.2.3",
"StatusInfo" : "{\"error_code\": \"S1\", \"error_msg\": \"Rsync not found. Please install rsync.\"}",
"SystemDiskSize" : 40,
"Description" : "Server Source Imported By GotoAliyun.",
"ErrorCode" : "SourceServer.Offline",
"JobId" : "j-bp19vlwm0tyigbmj****",
"Platform" : "OpenSUSE",
"ReplicationDriver" : "SMT",
"Name" : "SourceServerName",
"SystemInfo" : "{\\\"agent_mode\\\":\\\"daemon\\\",\\\"agent_type\\\":\\\"aliyun\\\",\\\"client_type\\\":\\\"\\\",\\\"cores\\\":\\\"2\\\",\\\"cpu_usage\\\":\\\"0.00\\\",\\\"hostname\\\":\\\"ixxxxxxxxxx\\\",\\\"ipv4\\\":\\\"10.0.0.1\\\",\\\"memory\\\":\\\"8.00\\\",\\\"memory_usage\\\":\\\"3.61\\\"}",
"Architecture" : "x86_64",
"ResourceGroupId" : "rg-acfmw3ty5y7****",
"Tags" : [ {
"Key" : "TestKey",
"Value" : "TestValue"
} ]
} ],
"TotalCount" : 1,
"PageSize" : 10,
"RequestId" : "410E6073-66D0-45D3-AB3E-4DC3F5E4****",
"PageNumber" : 1
}
Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
Você não tem permissões no recurso especificado. |
|
500 |
InternalError |
An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. |
Ocorreu um erro interno. Tente novamente mais tarde. Se o erro persistir, envie um ticket. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.