CreateVirtualNode を使用して Kubernetes クラスターを接続 - ECI - Alibaba Cloud - Elastic Container Instance

仮想ノード (VNode) を作成してセルフマネージド Kubernetes クラスターに接続し、クラスターが Elastic Container Instance (ECI) にリソースをスケールできるようにします。

操作説明

この操作を呼び出して仮想ノードを作成すると、システムは ECI、ECS、VPC などの関連クラウドサービスにアクセスするために、AliyunServiceRoleForECIVnode という名前のサービスリンクロールを自動的に作成します。詳細については、「仮想ノードのサービスリンクロール」を参照してください。
仮想ノードは数量に基づいて課金されます。各仮想ノードには、2 vCPU および 8 GiB メモリの ECI インスタンスに相当する常駐ノードがあります。対応する ECI インスタンス料金が発生します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

eci:CreateVirtualNode

create

*VirtualNode

acs:eci:{#regionId}:{#accountId}:virtualnode/*

eci:tag

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	リージョン ID。	cn-hangzhou
ZoneId	string	任意	ゾーンの ID。	cn-hangzhou-b
SecurityGroupId	string	必須	セキュリティグループ ID。仮想ノードおよび仮想ノード上に作成された ECI インスタンスがこのセキュリティグループに追加されます。	sg-2ze81zoc3yl7a3we****
VSwitchId	string	必須	vSwitch の ID。仮想ノードおよび仮想ノード上に作成された ECI インスタンスで使用される vSwitch です。同じ VPC に属する vSwitch を 1～10 個指定できます。	vsw-2ze23nqzig8inprou****
VirtualNodeName	string	任意	仮想ノードの名前。名前は 2～128 文字で、小文字、数字、ピリオド (.)、ハイフン (-) を含めることができます。	testNode
ResourceGroupId	string	任意	リソースグループの ID。	rg-uf66jeqopgqa9hdn****
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字以下にする必要があります。詳細については、「べき等性を確保する方法」を参照してください。	123e4567-e89b-12d3-a456-426655440000
EnablePublicNetwork	boolean	任意	パブリックネットワークアクセスを有効にするかどうかを指定します。デフォルト値: false。このパラメーターを true に設定すると、仮想ノードにパブリック IP アドレスが公開されます。	false
EipInstanceId	string	任意	Elastic IP Address (EIP) の ID。	eip-uf66jeqopgqa9hdn****
KubeConfig	string	任意	仮想ノードが接続する Kubernetes クラスターの KubeConfig。値は Base64 エンコードしてから渡す必要があります。	JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******
CustomResources	string	任意	仮想ノードでサポートされるカスタムリソース。ECI Pod がリクエスト内で対応するカスタムリソースを宣言している場合、その Pod は VNode にスケジュールされます。フォーマットは `resource_name=resource_count` です。複数のリソースはカンマ (,) で区切ります。	example1.com=100,example2.com=200
ClusterDomain	string	任意	クラスターのドメイン名。このパラメーターを設定すると、Kubelet はホストの検索ドメインに加えてこのドメインを検索するようにすべてのコンテナを設定します。	example.com
ClusterDNS	string	任意	DNS サーバの IP アドレス。ECI Pod で `dnsPolicy=ClusterFirst` がセットされている場合、この値がコンテナへの DNS サービス提供に使用されます。複数の IP アドレスを指定できます。複数の IP アドレスはカンマ (,) で区切ります。	100.1.XX.XX
Tag	array<object>	任意	仮想ノードのタグ情報。最大 20 個のタグを指定できます。
	object	任意	仮想ノードのタグ情報。
Key	string	任意	タグキー。	name
Value	string	任意	タグ値。	test
Taint	array<object>	任意	仮想ノードの Taint 情報。最大 20 個の Taint を指定できます。
	object	任意	仮想ノードの Taint 情報。
Key	string	任意	Taint のキー。	testKey
Value	string	任意	Taint の値。	testValue
Effect	string	任意	Taint の効果。有効な値: NoSchedule: この Taint を持つノードには Pod がスケジュールされません。 NoExecute: この Taint を持つノードには Pod がスケジュールされず、ノード上の既存の Pod は排除されます。 PreferNoSchedule: この Taint を持つノードには、可能な限り Pod がスケジュールされません。	NoSchedule
TlsBootstrapEnabled	boolean	任意	TLS ブートストラップを有効にするかどうかを指定します。この特徴を有効にする場合は、TLS ブートストラップに KubeConfig 証明書を使用します。有効な値: true: 有効。 false: 無効。デフォルト値: false。	false

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	89164E78-FC82-4684-BE97-DCDD85D26546
VirtualNodeId	string	仮想ノードの ID。	vnd-2ze960zkdqrldeaw****

例

成功レスポンス

JSONJSON

{
  "RequestId": "89164E78-FC82-4684-BE97-DCDD85D26546",
  "VirtualNodeId": "vnd-2ze960zkdqrldeaw****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	Account.Arrearage	Your account has an outstanding payment.	アカウントの支払い遅延が発生しています。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	ドライラン事前チェックリクエストは有効です。
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed
400	InvalidParameter.DuplicatedName	The container group include containers with duplicate names.	コンテナグループに重複する名前のコンテナが含まれています。
400	InvalidParameter.DuplicatedVolumeName	The container group includes volumes with duplicate names.	コンテナグループに重複する名前のボリュームが含まれています。
400	IncorrectStatus	%s	指定されたインスタンスステータスは無効です。
400	ServiceNotEnabled	%s	このリクエストが依存するサービスが有効化されていません。サービスを有効化してから再試行してください。
400	ImageSnapshot.IncorrectStatus	%s	イメージキャッシュに使用されるスナップショットが正しい状態ではありません。
400	ImageSnapshot.NotSupport	%s	データクラウドディスクスナップショットに基づくイメージキャッシュの特徴はまだすべてのリージョンで利用できません。この特徴が必要な場合は、お問い合わせください。
400	DiskVolume.NotSupport	The disk volume is not supported.	クラウドディスクボリュームはサポートされていません。この特徴が必要な場合は、お問い合わせください。
400	RamRole.NotSupport	The RAM role is not supported.	RAM インスタンスロールはサポートされていません。
400	DiskNumber.LimitExceed	The maximum number of disks in an instance is exceeded.	インスタンスにアタッチされているクラウドディスクの数が上限を超えています。
400	InvalidPaymentMethod.InsufficientBalance	No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance.	アカウントに有効な支払方法が設定されていません。支払方法を追加するか、十分な前払い残高を維持してください。
400	DiskVolume.NotInSameZone	The instance to be created and the disk are not in the same zone.	作成するインスタンスとクラウドディスクが同じゾーンにありません。
400	NoPermission	You are not authorized to use the "Product on ECI" feature.
400	HighCpuMemConfigRequired	You need to apply to be added to the whitelist of the specified CPU and memory.	高 CPU 構成のホワイトリストを申請する必要があります。
400	RecommendEmpty.InstanceTypeFamilyNotMatched	The recommended instance type is unavailable in the current zone. Try again later.	現在のゾーンには推奨されるインスタンスタイプがありません。後でもう一度お試しいただくか、別のゾーンでインスタンスを作成してください。
400	LocalDiskAmountNotMatch	The number of local volumes does not match the instance type.	ローカルディスクの数がインスタンスタイプと一致しません。
400	Payfor.CreditPayInsufficientBalance	Your payment credit line is insufficient.	与信限度額が不足しています。
400	InvalidOperation.KMS.InstanceTypeNotSupport	The specified instance is invalid. Only I/O optimized instances support KMS key.	指定されたインスタンスは無効です。KMS キーのセットをサポートするのは I/O 最適化インスタンスのみです。
400	InvalidParameter.Encrypted.KmsNotEnabled	KMS must be enabled for encrypted disks.	暗号化クラウドディスクを使用するには、Key Management Service を有効にする必要があります。
400	InvalidParameter.KMS.EncryptedIllegal	After configuring the parameter KmsKeyId, you must enable encryption.	KmsKeyId パラメーターを設定した後、暗号化属性を有効にする必要があります。
400	Ipv6AddressNotSupportVsw	IPv6 is not supported in the specified vSwitch.	vSwitch で IPv6 が有効になっていません。
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.	指定された EIP パブリックアドレスプールに十分なアドレスリソースがありません。
400	VnodeDedicatedHostIdAlreadyExist	DedicatedHostId:%s of Vnode:%s already exists.	指定された専用ホスト ID はすでに存在します。
400	DedicatedHostQuotaExceeded	The quota of DedicatedHost is exceeded.	専用ホストのクォータを超えています。
403	OperationDenied.VswZoneMisMatch	The specified VSwitchId is not in the specified Zone.
403	QuotaExceeded	%s quota exceeded.
403	Zone.NotOnSale	The specified zone is not available for purchase.	インスタンスを作成しようとしているゾーンは購入できなくなりました。別のゾーンを使用するか、または指定された VPC の vSwitch がこのゾーンで使用できません。
403	Forbidden.RiskControl	This operation has been identified as an abnormal operation and cannot be processed.	この操作は異常と判定されたため、処理できません。
403	Forbidden.SubUser	The specified action is not available for you.
403	Forbidden.OnlyForInvitedTest	Eci create action is only open to invited users during public beta.
403	OperationDenied.SecurityGroupMisMatch	The specified VSwitchId and SecurityGroupId are not in the same VPC.
403	InvalidVSwitchId.IpNotEnough	The specified VSwitch does not have enough IP addresses.
403	Forbidden.UserBussinessStatus	This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.	アカウントの支払い遅延が発生しているため、操作が禁止されています。アカウントに入金してから再試行してください。
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.	ユーザーが実名認証を完了していないため、操作が禁止されています。
403	InvalidUser.PassRoleForbidden	The RAM user is not authorized to assume a RAM role.	RAM ユーザーに RAM インスタンスロールを使用する権限がありません。
403	NoPermission	The RAM role does not belong to ECS.
403	OperationDenied.NoStock	Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
403	InvalidParameter.KMS.KeyId.Forbidden	You are not authorized to access the specified KMSKeyId.	指定された KmsKeyId にアクセスする権限がありません。
403	Forbidden.AccountClosed	The operation is forbidden. Your account has been closed.	ユーザーアカウントが登録解除されているため、操作が禁止されています。
403	InvalidOperation.ResourceManagedByCloudProduct	The operation is forbidden. The security group has been managed by another cloud product.	セキュリティグループは他のクラウドサービスによって管理されており、変更できません。
403	Spot.NotMatched	%s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	デフォルトのクレジットカードまたはデビットカードでセキュリティリスクが検出されました。メール内のリンクを使用してカードを確認してください。
403	CreateServiceLinkedRole.Denied	Please make sure the account has ram:CreateServiceLinkedRole permission.	アカウントに ram:CreateServiceLinkedRole 権限があることを確認してください。
404	ImageSnapshot.NotFound	The specified snapshot does not exist.	イメージキャッシュのスナップショットが存在しません。
404	InvalidDiskId.NotFound	The specified disk does not exist.	指定されたクラウドディスクが存在しません。
404	InvalidParameter.KMS.KeyId.NotFound	The specified KMSKeyId does not exist.	指定された KmsKeyId が存在しません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。