DescribeDedicatedHosts - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Adanmış ana bilgisayarların ayrıntılarını sorgulamak için aşağıdaki yöntemlerden birini kullanabilirsiniz:

Adanmış ana bilgisayarların ayrıntılarını sorgulamak için DedicatedHostIds parametresini belirtin.
Belirli bir adanmış ana bilgisayar kümesindeki adanmış ana bilgisayarların ayrıntılarını sorgulamak için DedicatedHostClusterId parametresini belirtin.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	DescribeDedicatedHosts	Gerçekleştirmek istediğiniz işlem. Değeri DescribeDedicatedHosts olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Adanmış ana bilgisayarın bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
ZoneId	String	Hayır	cn-hangzhou-g	Adanmış ana bilgisayarın alan kimliği. En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.
DedicatedHostIds	String	Hayır	["dh-bp165p6xk2tlw61e**", "dh-bp1f9vxmno7emy96**"]	Adanmış ana bilgisayarların kimlikleri. Tek bir istekte en fazla 100 adanmış ana bilgisayar kimliği belirtebilirsiniz. Kimlikleri virgül (,) ile ayırın.
DedicatedHostName	String	Hayır	MyDDHTestName	Adanmış ana bilgisayarın adı.
Status	String	Hayır	Available	Adanmış ana bilgisayarın hizmet durumu. Geçerli değerler: Available: Adanmış ana bilgisayar normal çalışıyor. UnderAssessment: Adanmış ana bilgisayar kullanılabilir durumda ancak adanmış ana bilgisayar üzerindeki ECS örneklerinin başarısız olmasına neden olabilecek potansiyel riskler taşıyor. PermanentFailure: Adanmış ana bilgisayar kalıcı hatalarla karşılaşıyor ve kullanılamıyor. TempUnavailable: Adanmış ana bilgisayar geçici olarak kullanılamıyor. Redeploying: Adanmış ana bilgisayar restore ediliyor. Varsayılan değer: Available.
DedicatedHostType	String	Hayır	ddh.g5	Adanmış ana bilgisayar türü. En güncel adanmış ana bilgisayar türleri listesini almak için DescribeDedicatedHostTypes işlemini çağırabilirsiniz.
LockReason	String	Hayır	financial	Adanmış ana bilgisayarın kilitlenme nedeni. Geçerli değerler: financial security
PageNumber	Integer	Hayır	1	Sayfa başına düşen giriş sayısı. Varsayılan değer: 1.
PageSize	Integer	Hayır	10	Sayfa numarası. Geçerli değerler: 1 ile 100 arasında. Varsayılan değer: 10.
ResourceGroupId	String	Hayır	rg-aek3b6jzp66****	Adanmış ana bilgisayarın ait olduğu kaynak grubunun kimliği. Kaynakları sorgulamak için bu parametre belirtildiğinde, yanıtta belirtilen kaynak grubuna ait en fazla 1.000 kaynak görüntülenebilir. Not Varsayılan kaynak grubundaki kaynaklar, bu parametre nasıl ayarlanırsa ayarlansın yanıtta görüntülenir.
Tag.N.Key	String	Hayır	TestKey	Adanmış ana bilgisayarın N. etiketinin anahtarı. N için geçerli değerler: 1 ile 20 arasında. Etiket anahtarı boş bir dize olamaz. Uzunluğu en fazla 128 karakter olabilir ve `acs:` veya `aliyun` ile başlayamaz. `http://` veya `https://` içeremez.
Tag.N.Value	String	Hayır	TestValue	Adanmış ana bilgisayarın N. etiketinin değeri. N için geçerli değerler: 1 ile 20 arasında. Etiket değeri boş bir dize olabilir. Uzunluğu en fazla 128 karakter olabilir ve `acs:` veya `aliyun` ile başlayamaz. `http://` veya `https://` içeremez.
DedicatedHostClusterId	String	Hayır	dc-bp12wlf6am0vz9v2****	Adanmış ana bilgisayarın ait olduğu adanmış ana bilgisayar kümesinin kimliği.
SocketDetails	String	Hayır	true	Soket bilgilerinin görüntülenip görüntülenmeyeceğini belirtir. Geçerli değerler: true false

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
PageSize	Integer	1	Sayfa başına düşen giriş sayısı.
RequestId	String	7654525A-9964-4ABB-8BCD-98F8835E809A	İstek kimliği.
PageNumber	Integer	5	Sayfa numarası.
TotalCount	Integer	3	Toplam adanmış ana bilgisayar sayısı.
DedicatedHosts	Array of DedicatedHost		Sorgulanan adanmış ana bilgisayarlar.
DedicatedHost
CreationTime	String	2018-01-01T12:00Z	Adanmış ana bilgisayarın oluşturulma zamanı. Zaman, `yyyy-MM-ddTHH:mmZ` formatında ISO 8601 standardını takip eder. Zaman UTC olarak gösterilir.
SchedulerOptions.ManagedPrivateSpaceId	String	mps-iq81z6pkbqjx61php46e	Adanmış ana bilgisayarın ait olduğu yönetilen özel alanın kimliği.
Status	String	Available	Adanmış ana bilgisayarın hizmet durumu. Geçerli değerler: Available: Adanmış ana bilgisayar normal çalışıyor. UnderAssessment: Adanmış ana bilgisayar kullanılabilir durumda ancak adanmış ana bilgisayar üzerindeki ECS örneklerinin başarısız olmasına neden olabilecek potansiyel riskler taşıyor. PermanentFailure: Adanmış ana bilgisayar kalıcı hatalarla karşılaşıyor ve kullanılamıyor.
Cores	Integer	3	CPU başına fiziksel çekirdek sayısı.
AutoPlacement	String	on	Adanmış ana bilgisayarın otomatik dağıtım için kaynak havuzuna eklenip eklenmediğini gösterir. Geçerli değerler: on: Adanmış ana bilgisayar otomatik dağıtım için kaynak havuzuna eklendi. off: Adanmış ana bilgisayar otomatik dağıtım için kaynak havuzuna eklenmedi. Otomatik dağıtım hakkında daha fazla bilgi için İşlevler ve özellikler konusundaki "Automatic deployment" bölümüne bakın.
GPUSpec	String	gpu	GPU modeli.
AutoReleaseTime	String	2017-01-01T12:00Z	Adanmış ana bilgisayarın otomatik serbest bırakılma zamanı. Zaman, `yyyy-MM-ddTHH:mmZ` formatında ISO 8601 standardını takip eder. Zaman UTC olarak gösterilir.
ChargeType	String	Prepaid	Adanmış ana bilgisayarın faturalama yöntemi.
CpuOverCommitRatio	Float	1	CPU aşırı tahsis oranı.
ActionOnMaintenance	String	Migrate	Adanmış ana bilgisayar başarısız olduğunda, adanmış ana bilgisayara dağıtılan örneklerin taşınması için kullanılan ilke. Geçerli değerler: Migrate: Örnekler başka bir fiziksel sunucuya taşınır. Adanmış ana bilgisayar başarısız olduğunda Durdurulmuş (Stopped) durumunda olmayan örnekler yeniden başlatılır. Stop: Örnekler durdurulur. Adanmış ana bilgisayar restore edilemezse örnekler başka bir fiziksel sunucuya taşınır ve yeniden başlatılır. Adanmış ana bilgisayara bağlı cloud diskler varsa varsayılan değer Migrate'tir. Adanmış ana bilgisayara bağlı local diskler varsa varsayılan değer Stop'tur.
SaleCycle	String	Month	Abonelik süresinin birimi. Geçerli değerler: Month Year
PhysicalGpus	Integer	10	Fiziksel GPU sayısı.
RegionId	String	cn-hangzhou	Adanmış ana bilgisayarın bölge kimliği.
DedicatedHostName	String	MyDDHTestName	Adanmış ana bilgisayarın adı.
Description	String	this-is-my-DDH	Adanmış ana bilgisayarın açıklaması.
DedicatedHostClusterId	String	dc-bp12wlf6am0vz9v2****	Adanmış ana bilgisayarın ait olduğu adanmış ana bilgisayar kümesinin kimliği.
ExpiredTime	String	2019-01-01T12:00Z	Abonelik tabanlı adanmış ana bilgisayarın sona erme zamanı. Zaman, `yyyy-MM-ddTHH:mmZ` formatında ISO 8601 standardını takip eder. Zaman UTC olarak gösterilir.
DedicatedHostType	String	ddh.g5	Adanmış ana bilgisayarın türü.
ResourceGroupId	String	rg-aek3b6jzp66****	Adanmış ana bilgisayarın ait olduğu kaynak grubunun kimliği.
ZoneId	String	cn-hangzhou-g	Adanmış ana bilgisayarın alan kimliği.
DedicatedHostId	String	dh-bp165p6xk2tlw61e****	Adanmış ana bilgisayarın kimliği.
Sockets	Integer	5	Fiziksel CPU sayısı.
MachineId	String	12aaa123456ff19dec12345d3026e****	Adanmış ana bilgisayarın makine kodu.
Instances	Array of Instance		Adanmış ana bilgisayarda oluşturulan ECS örnekleri.
Instance
InstanceType	String	ecs.g5.large	ECS örneğinin örnek türü.
InstanceId	String	i-bp14ot0ykf8w13a1****	ECS örneğinin kimliği.
SocketId	String	0,1	ECS örneğinin ait olduğu soketin kimliği.
InstanceOwnerId	Long	128************0	ECS örneği sahibinin kimliği.
OperationLocks	Array of OperationLock		Adanmış ana bilgisayar kaynaklarının kilitlenme nedenleri.
OperationLock
LockReason	String	financial	Adanmış ana bilgisayarın kilitlenme nedeni. Geçerli değerler: financial security
Tags	Array of Tag		Adanmış ana bilgisayarın etiketleri.
Tag
TagValue	String	TestValue	Adanmış ana bilgisayarın etiket değeri.
TagKey	String	TestKey	Adanmış ana bilgisayarın etiket anahtarı.
SupportedInstanceTypeFamilies	Array of String	ecs.g5	Adanmış ana bilgisayar tarafından desteklenen ECS örnek aileleri.
SupportedCustomInstanceTypeFamilies	Array of String	ecs.ddh6s.custom	Adanmış ana bilgisayar tarafından desteklenen özel ECS örnek aileleri.
SupportedInstanceTypesList	Array of String	ecs.g5.large	Adanmış ana bilgisayar tarafından desteklenen ECS örnek türleri.
Capacity	Object		Adanmış ana bilgisayarın performans teknik özellikleri.
AvailableMemory	Float	25	Kullanılabilir bellek miktarı. Birim: GiB.
LocalStorageCategory	String	i2	Local disk kullanan örnek ailesi.
TotalMemory	Float	1024	Toplam bellek kapasitesi. Birim: GiB.
TotalLocalStorage	Integer	512	Toplam local disk kapasitesi. Birim: GiB.
TotalVcpus	Integer	56	Toplam vCPU sayısı.
TotalVgpus	Integer	10	Toplam vGPU sayısı.
AvailableLocalStorage	Integer	65	Local disklerdeki kullanılabilir kapasite miktarı. Birim: GiB.
AvailableVcpus	Integer	5	Kullanılabilir vCPU sayısı.
AvailableVgpus	Integer	2	Kullanılabilir vGPU sayısı.
SocketCapacities	Array of SocketCapacity		Soket kapasiteleri.
SocketCapacity
SocketId	Integer	1	Soket kimliği.
AvailableMemory	Float	65	Kalan bellek kapasitesi. Birim: GiB.
TotalMemory	Float	128	Toplam bellek kapasitesi. Birim: GiB.
AvailableVcpu	Integer	64	Toplam vCPU sayısı.
TotalVcpu	Integer	128	Kullanılabilir vCPU sayısı.
NetworkAttributes	Object		Adanmış ana bilgisayarın ağ nitelikleri.
UdpTimeout	Integer	60	Adanmış ana bilgisayardaki bir kullanıcı ile bir Alibaba Cloud hizmeti arasında kurulan UDP oturumunun zaman aşımı süresi. Birim: saniye. Geçerli değer: 60.
SlbUdpTimeout	Integer	60	Server Load Balancer (SLB) ile adanmış ana bilgisayar arasında kurulan UDP oturumunun zaman aşımı süresi. Birim: saniye. Geçerli değer: 60.
HostDetailInfo	Object		Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz.
SerialNumber	String	null	Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz.
DedicatedHostOwnerId	Long	100************7	Adanmış ana bilgisayar sahibinin kimliği.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=DescribeDedicatedHosts
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&DedicatedHostIds=["dh-bp165p6xk2tlw61e****", "dh-bp1f9vxmno7emy96****"]
&DedicatedHostName=MyDDHTestName
&Status=Available
&DedicatedHostType=ddh.g5
&LockReason=financial
&PageNumber=1
&PageSize=10
&ResourceGroupId=rg-aek3b6jzp66****
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&DedicatedHostClusterId=dc-bp12wlf6am0vz9v2****
&SocketDetails=true
&<Common request parameters>

Başarılı yanıt örnekleri

XML formatı

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

<DescribeDedicatedHostsResponse>
    <PageSize>1</PageSize>
    <RequestId>7654525A-9964-4ABB-8BCD-98F8835E809A</RequestId>
    <PageNumber>5</PageNumber>
    <TotalCount>3</TotalCount>
    <DedicatedHosts>
        <CreationTime>2018-01-01T12:00Z</CreationTime>
        <SchedulerOptions.ManagedPrivateSpaceId>mps-iq81z6pkbqjx61php46e</SchedulerOptions.ManagedPrivateSpaceId>
        <Status>Available</Status>
        <Cores>3</Cores>
        <AutoPlacement>on</AutoPlacement>
        <GPUSpec>gpu</GPUSpec>
        <AutoReleaseTime>2017-01-01T12:00Z</AutoReleaseTime>
        <ChargeType>Prepaid</ChargeType>
        <CpuOverCommitRatio>1</CpuOverCommitRatio>
        <ActionOnMaintenance>Migrate</ActionOnMaintenance>
        <SaleCycle>Month</SaleCycle>
        <PhysicalGpus>10</PhysicalGpus>
        <RegionId>cn-hangzhou</RegionId>
        <DedicatedHostName>MyDDHTestName</DedicatedHostName>
        <Description>this-is-my-DDH</Description>
        <DedicatedHostClusterId>dc-bp12wlf6am0vz9v2****</DedicatedHostClusterId>
        <ExpiredTime>2019-01-01T12:00Z</ExpiredTime>
        <DedicatedHostType>ddh.g5</DedicatedHostType>
        <ResourceGroupId>rg-aek3b6jzp66****</ResourceGroupId>
        <ZoneId>cn-hangzhou-g</ZoneId>
        <DedicatedHostId>dh-bp165p6xk2tlw61e****</DedicatedHostId>
        <Sockets>5</Sockets>
        <MachineId>12aaa123456ff19dec12345d3026e****</MachineId>
        <Instances>
            <InstanceType>ecs.g5.large</InstanceType>
            <InstanceId>i-bp14ot0ykf8w13a1****</InstanceId>
            <SocketId>0,1</SocketId>
        </Instances>
        <OperationLocks>
            <LockReason>financial</LockReason>
        </OperationLocks>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
        <SupportedInstanceTypeFamilies>ecs.g5</SupportedInstanceTypeFamilies>
        <SupportedCustomInstanceTypeFamilies>ecs.ddh6s.custom</SupportedCustomInstanceTypeFamilies>
        <SupportedInstanceTypesList>ecs.g5.large</SupportedInstanceTypesList>
        <Capacity>
            <AvailableMemory>25</AvailableMemory>
            <LocalStorageCategory>i2</LocalStorageCategory>
            <TotalMemory>1024</TotalMemory>
            <TotalLocalStorage>512</TotalLocalStorage>
            <TotalVcpus>56</TotalVcpus>
            <TotalVgpus>10</TotalVgpus>
            <AvailableLocalStorage>65</AvailableLocalStorage>
            <AvailableVcpus>5</AvailableVcpus>
            <AvailableVgpus>2</AvailableVgpus>
            <SocketCapacities>
                <SocketId>1</SocketId>
                <AvailableMemory>65</AvailableMemory>
                <TotalMemory>128</TotalMemory>
                <AvailableVcpu>64</AvailableVcpu>
                <TotalVcpu>128</TotalVcpu>
            </SocketCapacities>
        </Capacity>
        <NetworkAttributes>
            <UdpTimeout>60</UdpTimeout>
            <SlbUdpTimeout>60</SlbUdpTimeout>
        </NetworkAttributes>
        <HostDetailInfo>
            <SerialNumber>null</SerialNumber>
        </HostDetailInfo>
    </DedicatedHosts>
</DescribeDedicatedHostsResponse>

JSON formatı

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

{
  "PageSize" : 1,
  "RequestId" : "7654525A-9964-4ABB-8BCD-98F8835E809A",
  "PageNumber" : 5,
  "TotalCount" : 3,
  "DedicatedHosts" : [ {
    "CreationTime" : "2018-01-01T12:00Z",
    "SchedulerOptions.ManagedPrivateSpaceId" : "mps-iq81z6pkbqjx61php46e",
    "Status" : "Available",
    "Cores" : 3,
    "AutoPlacement" : "on",
    "GPUSpec" : "gpu",
    "AutoReleaseTime" : "2017-01-01T12:00Z",
    "ChargeType" : "Prepaid",
    "CpuOverCommitRatio" : 1,
    "ActionOnMaintenance" : "Migrate",
    "SaleCycle" : "Month",
    "PhysicalGpus" : 10,
    "RegionId" : "cn-hangzhou",
    "DedicatedHostName" : "MyDDHTestName",
    "Description" : "this-is-my-DDH",
    "DedicatedHostClusterId" : "dc-bp12wlf6am0vz9v2****",
    "ExpiredTime" : "2019-01-01T12:00Z",
    "DedicatedHostType" : "ddh.g5",
    "ResourceGroupId" : "rg-aek3b6jzp66****",
    "ZoneId" : "cn-hangzhou-g",
    "DedicatedHostId" : "dh-bp165p6xk2tlw61e****",
    "Sockets" : 5,
    "MachineId" : "12aaa123456ff19dec12345d3026e****",
    "Instances" : [ {
      "InstanceType" : "ecs.g5.large",
      "InstanceId" : "i-bp14ot0ykf8w13a1****",
      "SocketId" : "0,1"
    } ],
    "OperationLocks" : [ {
      "LockReason" : "financial"
    } ],
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ],
    "SupportedInstanceTypeFamilies" : [ "ecs.g5" ],
    "SupportedCustomInstanceTypeFamilies" : [ "ecs.ddh6s.custom" ],
    "SupportedInstanceTypesList" : [ "ecs.g5.large" ],
    "Capacity" : {
      "AvailableMemory" : 25,
      "LocalStorageCategory" : "i2",
      "TotalMemory" : 1024,
      "TotalLocalStorage" : 512,
      "TotalVcpus" : 56,
      "TotalVgpus" : 10,
      "AvailableLocalStorage" : 65,
      "AvailableVcpus" : 5,
      "AvailableVgpus" : 2,
      "SocketCapacities" : [ {
        "SocketId" : 1,
        "AvailableMemory" : 65,
        "TotalMemory" : 128,
        "AvailableVcpu" : 64,
        "TotalVcpu" : 128
      } ]
    },
    "NetworkAttributes" : {
      "UdpTimeout" : 60,
      "SlbUdpTimeout" : 60
    },
    "HostDetailInfo" : {
      "SerialNumber" : "null"
    }
  } ]
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata iletisi	Açıklama
400	InvalidStatus.ValueNotSupported	The pecified dedicated host status is not supported.	Bu işlem, adanmış ana bilgisayarın mevcut durumunda gerçekleştirilemez.
400	MissingParamter.RegionId	The regionId should not be null.	RegionId gereklidir.
400	InvalidParameter.DedicatedHostIds	The specified parameter dedicatedHostIds is not valid.	Geçersiz DedicatedHostIds değeri.
400	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	Geçersiz RegionId değeri.
400	InvalidZone.NotFound	The specified parameter ZoneId is not valid.	Geçersiz ZoneId değeri.
403	InvalidDedicatedHostIds.Malformed	The amount of specified dedicatedHostIds exceeds the limit.	DedicatedHostIds değerinde 100'den fazla adanmış ana bilgisayar kimliği belirtilmiş.
404	InvalidLockReason.NotFound	The specified LockReason is not found.	Belirtilen LockReason değeri bulunamadı.

Hata kodlarının listesi için bkz. Service error codes.