Todos os produtos
Search
Central de documentação

:DescribeSourceServers

Última atualização: Jun 28, 2026

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

ParameterTypeRequiredExampleDescription
ActionStringYesDescribeSourceServers

A operação a ser executada. Defina o valor como DescribeSourceServers.

JobIdStringNoj-bp19vlwm0tyigbmj****

O ID do trabalho de migração.

StateStringNoAvailable

O estado da origem de migração. Valores válidos:

  • Unavailable: A origem de migração está inativa ou ocorreu um erro nela.
  • Available: A origem de migração está ativa.
  • InUse: A origem de migração está em processo de migração.
  • Deleting: A origem de migração está sendo excluída do Server Migration Center (SMC).
NameStringNotestSourceServerName

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.

PageNumberIntegerNo1

O número da página. A numeração começa em 1.

Valor padrão: 1.

PageSizeIntegerNo10

A quantidade de entradas por página. Valores válidos: 1 a 50.

Valor padrão: 10.

SourceId.NStringNos-bp1e2fsl57knvuug****

O ID da origem de migração. Você pode especificar vários IDs.

ResourceGroupIdStringNorg-acfmw3ty5y7****

O ID do grupo de recursos.

Tag.N.KeyStringNoTestKey

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.ValueStringNoTestValue

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

ParameterTypeExampleDescription
SourceServersArray of SourceServer

As origens de migração consultadas.

SourceServer
CreationTimeString2019-06-27T02:58:09Z

A hora de criação da origem de migração.

HeartbeatRateInteger30

O intervalo de envio de heartbeats pelo cliente SMC. Unidade: segundos.

StateStringInUse

O estado da origem de migração.

DataDisksArray of DataDisk

Os discos de dados na origem de migração.

DataDisk
IndexInteger1

O número de índice do disco de dados.

SizeInteger20

O tamanho do disco de dados. Unidade: GiB.

PartsArray of Part

As partições do disco de dados.

Part
CanBlockBooleanfalse

Indica se a replicação em bloco está ativada para a partição do disco de dados.

SizeBytesLong21474836480

O tamanho da partição do disco de dados. Unidade: bytes.

NeedBooleanfalse

Indica se a seleção da partição do disco de dados é obrigatória.

DeviceString1_0

O ID do dispositivo da partição do disco de dados.

PathString/home/data

O caminho da partição do disco de dados.

PathString/home/data

O caminho do disco de dados.

SystemDiskPartsArray of SystemDiskPart

As partições do disco do sistema.

SystemDiskPart
CanBlockBooleantrue

Indica se a replicação em bloco está ativada para a partição do disco do sistema.

SizeBytesLong254803968

O tamanho da partição do disco do sistema. Unidade: bytes.

NeedBooleantrue

Indica se a seleção da partição do disco do sistema é obrigatória.

DeviceString0_0

O ID do dispositivo da partição do disco do sistema.

PathString/boot

O caminho da partição do disco do sistema.

KernelLevelInteger1

O nível do kernel da origem de migração.

SourceIdStrings-bp1e2fsl57knvuug****

O ID da origem de migração.

AgentVersionString1.5.2.3

A versão do cliente SMC.

StatusInfoString{"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:


error_code
error_msg
                                
SystemDiskSizeInteger40

O tamanho do disco do sistema da origem de migração. Unidade: GiB.

DescriptionStringServer Source Imported By GotoAliyun.

A descrição da origem de migração.

ErrorCodeStringSourceServer.Offline

O código de erro da origem de migração.

JobIdStringj-bp19vlwm0tyigbmj****

O ID do último trabalho de migração.

PlatformStringOpenSUSE

O sistema operacional da origem de migração.

ReplicationDriverStringSMT

O driver de replicação usado na migração. Valor padrão: SMT.

NameStringSourceServerName

O nome da origem de migração.

SystemInfoString{\"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:


agent_mode: the migration mode. 
agent_type: the migration type. 
client_type: the client type. 
hostname: the hostname. 
ipv4: the IPv4 address. 
ipv6: the IPv6 address. 
cores: the number of CPU cores. 
cpu_usage: the CPU utilization. 
memory: the memory size. 
memory_usage: the memory usage. 
                                
ArchitectureStringx86_64

A arquitetura do sistema da origem de migração.

ResourceGroupIdStringrg-acfmw3ty5y7****

O ID do grupo de recursos.

TagsArray of Tag

As tags.

Tag
KeyStringTestKey

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://.

ValueStringTestValue

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://.

TotalCountInteger1

O número total de origens de migração retornadas.

PageSizeInteger10

A quantidade de entradas por página.

RequestIdString410E6073-66D0-45D3-AB3E-4DC3F5E4****

O ID da solicitação.

PageNumberInteger1

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.