パラメーターの説明
すべてのパラメータークラスは、属性情報を含む辞書オブジェクトに変換されます。
パラメーター | タイプ | 説明 |
cluster_desc | ClusterDescription オブジェクト、str、dict | クラスタの説明 |
レスポンスの説明
create_cluster メソッドは
CreateResponse
オブジェクトを返します。以下に、CreateResponse
オブジェクトの属性を示します。response.Id
を使用して、新しいクラスタの ID を取得できます。
属性 | タイプ | 説明 |
Id | str | 新しいクラスタの ID |
例
try:
// Client オブジェクトを初期化します。
client = ...
// ClusterDescription を参照します。
cluster_desc = ClusterDescription(...)
cluster = client.create_cluster(cluster_desc)
// クラスタ ID を出力します。
print (cluster.Id)
except ClientError, e:
print (e)
ClusterDescription クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、ClusterDescription オブジェクト | クラスタの説明を含むオブジェクト |
属性の説明
グループについては、GroupDescription クラスの説明を参照してください。
属性 | タイプ | 説明 |
Name | str | クラスタ名 |
Description | str | クラスタの簡単な説明 |
ImageId | str | イメージ ID。現在、ECS イメージ ID のみがサポートされています |
UserData | dict | ユーザー定義のキーと値のマッピング。ECS インスタンスのメタサーバーを使用して取得されます |
Groups | GroupDescription オブジェクト | クラスタ内のインスタンスグループに関する情報。JSON 形式で記述されます |
Configs | Configs オブジェクト | クラスタ構成 |
Notification | Notification オブジェクト | 通知メッセージの構成 |
メソッドの説明
メソッド | 説明 |
add_group(group_name, group) | インスタンスグループを追加します |
get_group(group_name) | インスタンスグループの名前基づいて、インスタンスグループに関する情報を取得します |
delete_group(group_name) | インスタンスグループを削除します |
GroupDescription クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、GroupDescription オブジェクト | クラスタ内のインスタンスグループに関する情報 |
属性の説明
属性 | タイプ | 説明 |
DesiredVMCount | int | 必要なインスタンス数 |
InstanceType | str | クラスタインスタンスタイプ |
ResourceType | str | リソースタイプ。オプション値には、OnDemand と Spot が含まれます |
SpotStrategy | str | インスタンスのスポット戦略。ResourceType が Spot の場合にのみ有効です。値:SpotWithPriceLimit (スポットインスタンスの最大価格を設定) および SpotAsPriceGo (システムが価格を自動的に提供し、最大値は従量課金制価格) |
SpotPriceLimit | float | 1 時間あたりのインスタンスの最大価格 (コア時間あたりの価格ではなく、各インスタンスタイプの価格)。値には最大 3 つの小数を含めることができます。SpotStrategy が SpotWithPriceLimit の場合に有効です |
Configs クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、GroupDescription オブジェクト | クラスタ構成 |
属性の説明
属性 | タイプ | 説明 |
Disks | Disks オブジェクト | クラスタ内のインスタンスのディスク構成 |
Mounts | オブジェクト | クラスタ作成時のネットワークディスクのマウント構成 |
Networks | Networks オブジェクト | クラスタ内のインスタンスのネットワーク構成。Networks によって記述されます |
メソッドの説明
メソッド | 説明 |
addsystem_disk(size, type) | システムディスクのサイズとタイプを設定します。現在、サポートされているタイプは cloud と ephemeral です |
adddata_disk(size, type, mount_point) | データディスクを追加および設定します。現在、サポートされているタイプは cloud と ephemeral です |
Disks クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Disks オブジェクト | クラスタのディスク構成 |
属性の説明
属性 | タイプ | 説明 |
SystemDisk | SystemDisk オブジェクト | システムディスクの構成 |
DataDisk | DataDisk オブジェクト | データディスクの構成 |
SystemDisk クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、SystemDisk オブジェクト | システムディスクの構成 |
属性の説明
属性 | タイプ | 説明 |
Size | int | システムディスクのサイズ |
Type | str | データディスクのタイプ |
DataDisk クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、DataDisk オブジェクト | データディスクの構成 |
属性の説明
属性 | タイプ | 説明 |
Size | int | システムディスクのサイズ |
Type | str | データディスクのタイプ |
MountPoint | str | Linux システムでデータディスクをマウントする必要があるディレクトリ |
Notification クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | ユーザープログラムに関連するコマンドラインパラメーター |
属性の説明
属性 | タイプ | 説明 |
Topic | Topic オブジェクト | メッセージトピック |
Topic クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | ユーザープログラムに関連するコマンドラインパラメーター |
属性の説明
属性 | タイプ | 説明 |
Endpoint | str | MNS リージョンのエンドポイント。形式は http://${your_user_id}.mns.${region}-internal.aliyuncs.com/ です。可能な限りイントラネットエンドポイントを使用してください |
Name | str | トピック名 |
Events | list | イベントのリスト。クラスタ関連のイベントを入力してください |
Mounts クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | クラスタ作成時のネットワークディスクのマウント構成 |
属性の説明
属性 | タイプ | 説明 |
Entries | array | ネットワークディスクのマウントポイントのリスト。MountPoint によって記述されます |
Locale | str | OSS または NAS ストレージのマウント時に使用される言語 |
Lock | bool | OSS または NAS ストレージのマウント時にファイルロックがサポートされるかどうかを指定します |
NAS | dict | NAS 構成 |
OSS | dict | OSS 構成 |
MountPoint クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | ネットワークマウントポイント |
属性の説明
属性 | タイプ | 説明 |
Source | str | ネットワークディスクマウントのソースディレクトリ。「nas://」または「oss://」で始まる文字列を指定できます |
Destination | str | ネットワークディスクのローカルマウントポイントディレクトリ |
WriteSupport | bool | マウントポイントが書き込み可能かどうかを指定します |
NAS クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | NAS 構成 |
属性の説明
属性 | タイプ | 説明 |
AccessGroup | list | クラスタインスタンスを追加する必要がある NAS アクセスグループ |
FileSystem | list | アクセスするファイルシステム |
OSS クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | OSS 構成 |
属性の説明
属性 | タイプ | 説明 |
AccessKeyId | str | OSS マウントに使用される AccessKey ID |
AccessKeySecret | str | OSS マウントに使用される AccessKey Secret |
SecurityToken | str | OSS マウントに使用されるセキュリティトークン |
注記: Mounts については、次の点に注意してください。ジョブレベルの Mounts 構成は、クラスタレベルの Mounts 構成を上書きします。クラスタを変更した後、RecreateInstance インターフェースを呼び出して、新しい Mounts 構成を有効にする必要があります。NAS マウント中、ソースディレクトリは「nas:」で始まる必要があります。そうでない場合、エラーが発生します。
Networks クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | クラスタ作成時のネットワーク構成 |
属性の説明
属性 | タイプ | 説明 |
Classic | dict | クラシックネットワーク構成。Classic によって記述されます |
Classic クラス
パラメーターの説明
パラメーター | タイプ | 説明 |
properties | dict、str、Command オブジェクト | クラシックネットワーク構成 |
属性の説明
属性 | タイプ | 説明 |
AllowIpAddress | list | インバウンドトラフィックを許可する IP アドレス |
AllowIpAddressEgress | list | アウトバウンドトラフィックを許可する IP アドレス |
AllowSecurityGroup | list | インバウンドトラフィックを許可するセキュリティグループ |
AllowSecurityGroupEgress | list | アウトバウンドトラフィックを許可するセキュリティグループ |
例:
try:
// ここに他のコードを記述します
Client = Client(...
...
cluster_desc = ClusterDescription()
group_desc = GroupDescription()
configs = Configs()
group_desc.DesiredVMCount = 1
group_desc.InstanceType = "ecs.t1.small"
cluster_desc.add_group("group1", group_desc)
configs.add_system_disk(40, 'ephemeral')
configs.add_data_disk(40, 'ephemeral')
cluster_desc.Configs = configs
cluster_desc.Name = "BatchcomputePythonSDK"
// image_id は、以前に BatchCompute サービスで作成されたイメージです。
// または、ECS イメージ ID です。
cluster_desc.ImageId = image_id
print cluster_desc.Configs.Disks.SystemDisk.Type
print cluster_desc.Configs.Disks.SystemDisk.Size
print cluster_desc.Configs.Disks.DataDisk.Type
print cluster_desc.Configs.Disks.DataDisk.Size
print client.create_cluster(cluster_desc).Id
except ClientError, e:
print (e.get_status_code(), e.get_code(), e.get_requestid(), e.get_msg())