DescribeSourceServers - - Alibaba Cloud Dokümantasyon Merkezi

Bir veya daha fazla geçiş kaynağı hakkında bilgi sorgulamak için DescribeSourceServers işlemini çağırır.

Operation description

Açıklama

İstek parametreleri filtre olarak kullanılır ve mantıksal VE ile birleştirilir. Bir parametre boşsa, karşılık gelen filtre yoksayılır.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

smc:DescribeSourceServers

get

*SourceServer

acs:smc:{#regionId}:{#accountId}:sourceserver/{#SourceServerId}

None

Request parameters

Parameter	Type	Required	Description	Example
JobId	string	No	Geçiş görevinin kimliği.	j-bp19vlwm0tyigbmj****
State	string	No	Kaynak sunucunun durumu. Geçerli değerler: Unavailable: Kaynak sunucu kullanılamaz. Bu durum çevrimdışı ve hata durumlarını içerir. Available: Kaynak sunucu çevrimiçidir. InUse: Kaynak sunucu için geçiş işlemi devam etmektedir. Deleting: Kaynak sunucu silinmektedir.	Available
Name	string	No	Kaynak sunucunun adı. Ad, 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalıdır ve http:// veya https:// ile başlayamaz. Ad; rakamlar, iki nokta üst üste (:), alt çizgiler (_) ve tireler (-) içerebilir. Varsayılan değer: boş.	testSourceServerName
PageNumber	integer	No	Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.	1
PageSize	integer	No	Sayfa başına giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.	10
SourceId	array	No	Kaynak sunucunun kimliği. Birden fazla kimlik belirtebilirsiniz.	s-bp1e2fsl57knvuug****
	string	No	Kaynak sunucunun kimliği. Birden fazla kimlik belirtebilirsiniz.	s-bp1e2fsl57knvuug****
ResourceGroupId	string	No	Kaynak grubunun kimliği.	rg-acfmw3ty5y7****
Tag	array<object>	No	Etiketler.
	object	No	Etiket.
Key	string	No	N etiketinin anahtarı. N, 1 ile 20 arasında bir tam sayı olabilir. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.	TestKey
Value	string	No	N etiketinin değeri. N, 1 ile 20 arasında bir tam sayı olabilir. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 64 karakter uzunluğunda olabilir. http:// veya https:// içeremez.	TestValue
RelatedJobType	array	No	İlişkili görevin türü.
	string	No	İlişkili görevin türü. Geçerli değerler: Not_Related: İlişkili bir görev yoktur. Server: Bir sunucu geçiş görevi. Os: Bir işletim sistemi geçiş görevi. Cross_Zone: Bir bölgeler arası geçiş görevi. VMWare: Bir VMware geçiş görevi. Desktop: Bir masaüstü görevi.	Server
WorkgroupId	string	No	Çalışma grubunun kimliği.	w-bp1ja22kdqphehlj****

Response elements

Element	Type	Description	Example
	object	Yanıt parametreleri.
SourceServers	object
SourceServer	array<object>	Kaynak sunucular hakkındaki bilgiler.
	array<object>	Kaynak sunucular hakkındaki bilgiler.
CreationTime	string	Kaynak sunucunun oluşturulma zamanı.	2019-06-27T02:58:09Z
HeartbeatRate	integer	Server Migration Center (SMC) istemcisinin kalp atışı aralığı. Birim: saniye.	30
State	string	Kaynak sunucunun durumu.	InUse
DataDisks	object
DataDisk	array<object>	Kaynak sunucunun veri diskleri.
	array<object>	Kaynak sunucunun veri diskleri.
Index	integer	Veri diskinin dizin numarası.	1
Size	integer	Veri diskinin boyutu. Birim: GiB.	20
Parts	object
Part	array<object>	Veri diskinin bölümleri.
	object	Veri diskinin bölümleri.
CanBlock	boolean	Veri diski bölümü için blok çoğaltmanın desteklenip desteklenmediğini gösterir.	false
SizeBytes	integer	Veri diski bölümünün boyutu. Birim: bayt.	21474836480
Need	boolean	Veri diski bölümünün seçilmesinin zorunlu olup olmadığını gösterir.	false
Device	string	Veri diski bölümünün aygıt kimliği.	1_0
Path	string	Veri diski bölümünün bağlama noktası.	/home/data
Path	string	Veri diskinin bağlama noktası.	/home/data
SystemDiskParts	object
SystemDiskPart	array<object>	Sistem diskinin bölümleri.
	object	Sistem diskinin bölümleri.
CanBlock	boolean	Sistem diski bölümü için blok çoğaltmanın desteklenip desteklenmediğini gösterir.	true
SizeBytes	integer	Sistem diski bölümünün boyutu. Birim: bayt.	254803968
Need	boolean	Sistem diski bölümünün seçilmesinin zorunlu olup olmadığını gösterir.	true
Device	string	Sistem diski bölümünün aygıt kimliği.	0_0
Path	string	Sistem diski bölümünün bağlama noktası.	/boot
KernelLevel	integer	Çekirdek seviyesi.	1
SourceId	string	Kaynak sunucunun kimliği.	s-bp1e2fsl57knvuug****
AgentVersion	string	SMC istemcisinin sürümü.	1.5.2.3
StatusInfo	string	Kaynak sunucunun durumu hakkındaki bilgiler. Bu parametre, kaynak sunucu anormal bir durumdayken döndürülür. Değer, JSON biçiminde bir anahtar-değer çiftidir. Örnek: `- error_code: Hata kodu. - error_msg: Hata mesajı.`	{"error_code": "S1", "error_msg": "Rsync not found. Please install rsync."}
SystemDiskSize	integer	Kaynak sunucunun sistem diskinin boyutu. Birim: GiB.	40
Description	string	Kaynak sunucunun açıklaması.	Server Source Imported By GotoAliyun.
ErrorCode	string	Kaynak sunucu anormal bir durumdaysa döndürülen hata kodu.	SourceServer.Offline
JobId	string	Son geçiş görevinin kimliği.	j-bp19vlwm0tyigbmj****
Platform	string	Kaynak sunucunun işletim sistemi.	OpenSUSE
ReplicationDriver	string	Çoğaltma sürücüsü. Varsayılan değer: SMT.	SMT
Name	string	Kaynak sunucunun adı.	SourceServerName
SystemInfo	string	Kaynak sunucunun sistem bilgileri. Değer, boyutu 1 KB'ı aşamayan JSON biçiminde bir anahtar-değer çiftidir. Örnek: `agent_mode: Çalıştırma modu. agent_type: Çalıştırma türü. client_type: İstemci türü. hostname: Ana bilgisayar adı. ipv4: IPv4 adresi. ipv6: IPv6 adresi. cores: CPU çekirdeği sayısı. cpu_usage: CPU kullanımı. memory: Bellek boyutu. memory_usage: Bellek kullanımı.`	{\"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	string	Kaynak sunucunun mimarisi.	x86_64
ResourceGroupId	string	Kaynak grubunun kimliği.	rg-acfmw3ty5y7****
Tags	object
Tag	array<object>	Etiketler.
	object	Etiket.
Key	string	N etiketinin anahtarı. N, 1 ile 20 arasında bir tam sayı olabilir. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.	TestKey
Value	string	N etiketinin değeri. N, 1 ile 20 arasında bir tam sayı olabilir. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 64 karakter uzunluğunda olabilir. http:// veya https:// içeremez.	TestValue
Disks	object	Diskler hakkındaki bilgiler.
System	object	Sistem diski hakkındaki bilgiler.
Size	integer	Kaynak sunucunun sistem diskinin boyutu. Birim: GiB. Değer 20 ile 32.768 aralığında olmalıdır. Not Bu parametrenin değeri, kaynak sunucudaki veri diskinin kullanılan alanından büyük olmalıdır. Örneğin, veri diskinin boyutu 500 GiB ve alanın 100 GiB'ı kullanılıyorsa, bu parametrenin değeri 100'den büyük olmalıdır.	100
Offset	integer	Sistem diskindeki ilk bölümün başlangıç ofseti. Birim: bayt.	1024
Parts	object
Part	array<object>	Sistem diskinin bölümleri.
	object	Bölüm hakkındaki bilgiler.
CanBlock	boolean	Sistem diski bölümü için blok çoğaltmanın desteklenip desteklenmediğini gösterir. Geçerli değerler: true: Sistem diski bölümü için blok çoğaltma desteklenir. false: Sistem diski bölümü için blok çoğaltma desteklenmez.	false
SizeBytes	integer	Sistem diski bölümünün boyutu. Birim: bayt.	21474836480
Path	string	Sistem diski bölümünün bağlama noktası.	/home/data
Type	string	Sistem diski bölümünün türü. Geçerli değerler: Normal: Normal bir bölüm. System: Bir sistem bölümü. Boot: Bir önyükleme bölümü.	Normal
Data	object
Data	array<object>	Veri diskleri hakkındaki bilgiler.
	array<object>	Veri diski hakkındaki bilgiler.
Size	integer	Kaynak sunucunun veri diskinin boyutu. Birim: GiB.	80
Offset	integer	Veri diskindeki ilk bölümün başlangıç ofseti. Birim: bayt.	1024
Parts	object
Part	array<object>	Veri diskinin bölümleri.
	object	Veri diski bölümleri hakkındaki bilgiler.
CanBlock	boolean	Indicates whether block replication is enabled for the data disk partition. Valid values: true: Block replication is enabled for the data disk partition. false: Block replication is not enabled for the data disk partition.	false
SizeBytes	integer	The size of the data disk partition. Unit: bytes.	21474836480
Path	string	The mount point of the data disk partition.	/home/data
Type	string	The type of the data disk partition. Valid values: Normal: A normal partition. System: A system partition. Boot: A boot partition.	Normal
WorkgroupId	string	Çalışma grubunun kimliği.	w-bp1ja22kdqphehlj****
TotalCount	integer	Toplam kaynak sunucu sayısı.	1
PageSize	integer	Sayfa başına giriş sayısı.	10
RequestId	string	İsteğin kimliği.	410E6073-66D0-45D3-AB3E-4DC3F5E4****
PageNumber	integer	Sayfa numarası.	1

Examples

Success response

JSON format

{
  "SourceServers": {
    "SourceServer": [
      {
        "CreationTime": "2019-06-27T02:58:09Z",
        "HeartbeatRate": 30,
        "State": "InUse",
        "DataDisks": {
          "DataDisk": [
            {
              "Index": 1,
              "Size": 20,
              "Parts": {
                "Part": [
                  {
                    "CanBlock": false,
                    "SizeBytes": 21474836480,
                    "Need": false,
                    "Device": "1_0",
                    "Path": "/home/data"
                  }
                ]
              },
              "Path": "/home/data"
            }
          ]
        },
        "SystemDiskParts": {
          "SystemDiskPart": [
            {
              "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": {
          "Tag": [
            {
              "Key": "TestKey",
              "Value": "TestValue"
            }
          ]
        },
        "Disks": {
          "System": {
            "Size": 100,
            "Offset": 1024,
            "Parts": {
              "Part": [
                {
                  "CanBlock": false,
                  "SizeBytes": 21474836480,
                  "Path": "/home/data",
                  "Type": "Normal"
                }
              ]
            }
          },
          "Data": {
            "Data": [
              {
                "Size": 80,
                "Offset": 1024,
                "Parts": {
                  "Part": [
                    {
                      "CanBlock": false,
                      "SizeBytes": 21474836480,
                      "Path": "/home/data",
                      "Type": "Normal"
                    }
                  ]
                }
              }
            ]
          }
        },
        "WorkgroupId": "w-bp1ja22kdqphehlj****"
      }
    ]
  },
  "TotalCount": 1,
  "PageSize": 10,
  "RequestId": "410E6073-66D0-45D3-AB3E-4DC3F5E4****",
  "PageNumber": 1
}

Error codes

HTTP status code	Error code	Error message	Description
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.