@alicloud/ecs20140526 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/client.d.ts CHANGED
@@ -1509,6 +1509,7 @@ export declare class CreateAutoProvisioningGroupRequest extends $tea.Model {
1509
1509
  spotInstancePoolsToUseCount?: number;
1510
1510
  spotTargetCapacity?: string;
1511
1511
  systemDiskConfig?: CreateAutoProvisioningGroupRequestSystemDiskConfig[];
1512
+ tag?: CreateAutoProvisioningGroupRequestTag[];
1512
1513
  terminateInstances?: boolean;
1513
1514
  terminateInstancesWithExpiration?: boolean;
1514
1515
  totalTargetCapacity?: string;
@@ -1556,6 +1557,7 @@ export declare class CreateAutoProvisioningGroupResponse extends $tea.Model {
1556
1557
  }
1557
1558
  export declare class CreateAutoSnapshotPolicyRequest extends $tea.Model {
1558
1559
  copiedSnapshotsRetentionDays?: number;
1560
+ copyEncryptionConfiguration?: CreateAutoSnapshotPolicyRequestCopyEncryptionConfiguration;
1559
1561
  enableCrossRegionCopy?: boolean;
1560
1562
  ownerId?: number;
1561
1563
  resourceGroupId?: string;
@@ -5631,6 +5633,7 @@ export declare class DescribeAutoProvisioningGroupsRequest extends $tea.Model {
5631
5633
  resourceGroupId?: string;
5632
5634
  resourceOwnerAccount?: string;
5633
5635
  resourceOwnerId?: number;
5636
+ tag?: DescribeAutoProvisioningGroupsRequestTag[];
5634
5637
  static names(): {
5635
5638
  [key: string]: string;
5636
5639
  };
@@ -6049,6 +6052,54 @@ export declare class DescribeClassicLinkInstancesResponse extends $tea.Model {
6049
6052
  [key: string]: any;
6050
6053
  });
6051
6054
  }
6055
+ export declare class DescribeCloudAssistantSettingsRequest extends $tea.Model {
6056
+ ownerAccount?: string;
6057
+ ownerId?: number;
6058
+ regionId?: string;
6059
+ resourceOwnerAccount?: string;
6060
+ resourceOwnerId?: number;
6061
+ settingType?: string[];
6062
+ static names(): {
6063
+ [key: string]: string;
6064
+ };
6065
+ static types(): {
6066
+ [key: string]: any;
6067
+ };
6068
+ constructor(map?: {
6069
+ [key: string]: any;
6070
+ });
6071
+ }
6072
+ export declare class DescribeCloudAssistantSettingsResponseBody extends $tea.Model {
6073
+ agentUpgradeConfig?: DescribeCloudAssistantSettingsResponseBodyAgentUpgradeConfig;
6074
+ ossDeliveryConfigs?: DescribeCloudAssistantSettingsResponseBodyOssDeliveryConfigs;
6075
+ requestId?: string;
6076
+ slsDeliveryConfigs?: DescribeCloudAssistantSettingsResponseBodySlsDeliveryConfigs;
6077
+ static names(): {
6078
+ [key: string]: string;
6079
+ };
6080
+ static types(): {
6081
+ [key: string]: any;
6082
+ };
6083
+ constructor(map?: {
6084
+ [key: string]: any;
6085
+ });
6086
+ }
6087
+ export declare class DescribeCloudAssistantSettingsResponse extends $tea.Model {
6088
+ headers?: {
6089
+ [key: string]: string;
6090
+ };
6091
+ statusCode?: number;
6092
+ body?: DescribeCloudAssistantSettingsResponseBody;
6093
+ static names(): {
6094
+ [key: string]: string;
6095
+ };
6096
+ static types(): {
6097
+ [key: string]: any;
6098
+ };
6099
+ constructor(map?: {
6100
+ [key: string]: any;
6101
+ });
6102
+ }
6052
6103
  export declare class DescribeCloudAssistantStatusRequest extends $tea.Model {
6053
6104
  instanceId?: string[];
6054
6105
  maxResults?: number;
@@ -6367,6 +6418,8 @@ export declare class DescribeDedicatedHostsRequest extends $tea.Model {
6367
6418
  dedicatedHostName?: string;
6368
6419
  dedicatedHostType?: string;
6369
6420
  lockReason?: string;
6421
+ maxResults?: number;
6422
+ nextToken?: string;
6370
6423
  ownerAccount?: string;
6371
6424
  ownerId?: number;
6372
6425
  pageNumber?: number;
@@ -6391,6 +6444,7 @@ export declare class DescribeDedicatedHostsRequest extends $tea.Model {
6391
6444
  }
6392
6445
  export declare class DescribeDedicatedHostsResponseBody extends $tea.Model {
6393
6446
  dedicatedHosts?: DescribeDedicatedHostsResponseBodyDedicatedHosts;
6447
+ nextToken?: string;
6394
6448
  pageNumber?: number;
6395
6449
  pageSize?: number;
6396
6450
  requestId?: string;
@@ -8355,11 +8409,16 @@ export declare class DescribeInstanceTypeFamiliesResponse extends $tea.Model {
8355
8409
  }
8356
8410
  export declare class DescribeInstanceTypesRequest extends $tea.Model {
8357
8411
  cpuArchitecture?: string;
8412
+ cpuArchitectures?: string[];
8358
8413
  GPUSpec?: string;
8414
+ gpuSpecs?: string[];
8415
+ instanceCategories?: string[];
8359
8416
  instanceCategory?: string;
8360
8417
  instanceFamilyLevel?: string;
8418
+ instanceTypeFamilies?: string[];
8361
8419
  instanceTypeFamily?: string;
8362
8420
  instanceTypes?: string[];
8421
+ localStorageCategories?: string[];
8363
8422
  localStorageCategory?: string;
8364
8423
  maxResults?: number;
8365
8424
  maximumCpuCoreCount?: number;
@@ -8393,6 +8452,7 @@ export declare class DescribeInstanceTypesRequest extends $tea.Model {
8393
8452
  ownerAccount?: string;
8394
8453
  ownerId?: number;
8395
8454
  physicalProcessorModel?: string;
8455
+ physicalProcessorModels?: string[];
8396
8456
  resourceOwnerAccount?: string;
8397
8457
  resourceOwnerId?: number;
8398
8458
  static names(): {
@@ -11156,6 +11216,56 @@ export declare class DescribeTasksResponse extends $tea.Model {
11156
11216
  [key: string]: any;
11157
11217
  });
11158
11218
  }
11219
+ export declare class DescribeTerminalSessionsRequest extends $tea.Model {
11220
+ instanceId?: string;
11221
+ maxResults?: number;
11222
+ nextToken?: string;
11223
+ ownerAccount?: string;
11224
+ ownerId?: number;
11225
+ regionId?: string;
11226
+ resourceOwnerAccount?: string;
11227
+ resourceOwnerId?: number;
11228
+ sessionId?: string;
11229
+ static names(): {
11230
+ [key: string]: string;
11231
+ };
11232
+ static types(): {
11233
+ [key: string]: any;
11234
+ };
11235
+ constructor(map?: {
11236
+ [key: string]: any;
11237
+ });
11238
+ }
11239
+ export declare class DescribeTerminalSessionsResponseBody extends $tea.Model {
11240
+ nextToken?: string;
11241
+ requestId?: string;
11242
+ sessions?: DescribeTerminalSessionsResponseBodySessions;
11243
+ static names(): {
11244
+ [key: string]: string;
11245
+ };
11246
+ static types(): {
11247
+ [key: string]: any;
11248
+ };
11249
+ constructor(map?: {
11250
+ [key: string]: any;
11251
+ });
11252
+ }
11253
+ export declare class DescribeTerminalSessionsResponse extends $tea.Model {
11254
+ headers?: {
11255
+ [key: string]: string;
11256
+ };
11257
+ statusCode?: number;
11258
+ body?: DescribeTerminalSessionsResponseBody;
11259
+ static names(): {
11260
+ [key: string]: string;
11261
+ };
11262
+ static types(): {
11263
+ [key: string]: any;
11264
+ };
11265
+ constructor(map?: {
11266
+ [key: string]: any;
11267
+ });
11268
+ }
11159
11269
  export declare class DescribeUserBusinessBehaviorRequest extends $tea.Model {
11160
11270
  ownerAccount?: string;
11161
11271
  ownerId?: number;
@@ -12245,6 +12355,7 @@ export declare class ImportImageRequest extends $tea.Model {
12245
12355
  resourceOwnerAccount?: string;
12246
12356
  resourceOwnerId?: number;
12247
12357
  roleName?: string;
12358
+ storageLocationArn?: string;
12248
12359
  tag?: ImportImageRequestTag[];
12249
12360
  static names(): {
12250
12361
  [key: string]: string;
@@ -12828,6 +12939,7 @@ export declare class ModifyAutoSnapshotPolicyResponse extends $tea.Model {
12828
12939
  }
12829
12940
  export declare class ModifyAutoSnapshotPolicyExRequest extends $tea.Model {
12830
12941
  copiedSnapshotsRetentionDays?: number;
12942
+ copyEncryptionConfiguration?: ModifyAutoSnapshotPolicyExRequestCopyEncryptionConfiguration;
12831
12943
  enableCrossRegionCopy?: boolean;
12832
12944
  ownerId?: number;
12833
12945
  resourceOwnerAccount?: string;
@@ -12974,6 +13086,74 @@ export declare class ModifyCapacityReservationResponse extends $tea.Model {
12974
13086
  [key: string]: any;
12975
13087
  });
12976
13088
  }
13089
+ export declare class ModifyCloudAssistantSettingsRequest extends $tea.Model {
13090
+ agentUpgradeConfig?: ModifyCloudAssistantSettingsRequestAgentUpgradeConfig;
13091
+ ossDeliveryConfig?: ModifyCloudAssistantSettingsRequestOssDeliveryConfig;
13092
+ ownerAccount?: string;
13093
+ ownerId?: number;
13094
+ regionId?: string;
13095
+ resourceOwnerAccount?: string;
13096
+ resourceOwnerId?: number;
13097
+ settingType?: string;
13098
+ slsDeliveryConfig?: ModifyCloudAssistantSettingsRequestSlsDeliveryConfig;
13099
+ static names(): {
13100
+ [key: string]: string;
13101
+ };
13102
+ static types(): {
13103
+ [key: string]: any;
13104
+ };
13105
+ constructor(map?: {
13106
+ [key: string]: any;
13107
+ });
13108
+ }
13109
+ export declare class ModifyCloudAssistantSettingsShrinkRequest extends $tea.Model {
13110
+ agentUpgradeConfigShrink?: string;
13111
+ ossDeliveryConfigShrink?: string;
13112
+ ownerAccount?: string;
13113
+ ownerId?: number;
13114
+ regionId?: string;
13115
+ resourceOwnerAccount?: string;
13116
+ resourceOwnerId?: number;
13117
+ settingType?: string;
13118
+ slsDeliveryConfigShrink?: string;
13119
+ static names(): {
13120
+ [key: string]: string;
13121
+ };
13122
+ static types(): {
13123
+ [key: string]: any;
13124
+ };
13125
+ constructor(map?: {
13126
+ [key: string]: any;
13127
+ });
13128
+ }
13129
+ export declare class ModifyCloudAssistantSettingsResponseBody extends $tea.Model {
13130
+ requestId?: string;
13131
+ static names(): {
13132
+ [key: string]: string;
13133
+ };
13134
+ static types(): {
13135
+ [key: string]: any;
13136
+ };
13137
+ constructor(map?: {
13138
+ [key: string]: any;
13139
+ });
13140
+ }
13141
+ export declare class ModifyCloudAssistantSettingsResponse extends $tea.Model {
13142
+ headers?: {
13143
+ [key: string]: string;
13144
+ };
13145
+ statusCode?: number;
13146
+ body?: ModifyCloudAssistantSettingsResponseBody;
13147
+ static names(): {
13148
+ [key: string]: string;
13149
+ };
13150
+ static types(): {
13151
+ [key: string]: any;
13152
+ };
13153
+ constructor(map?: {
13154
+ [key: string]: any;
13155
+ });
13156
+ }
12977
13157
  export declare class ModifyCommandRequest extends $tea.Model {
12978
13158
  commandContent?: string;
12979
13159
  commandId?: string;
@@ -17622,6 +17802,7 @@ export declare class StartTerminalSessionRequest extends $tea.Model {
17622
17802
  resourceOwnerAccount?: string;
17623
17803
  resourceOwnerId?: number;
17624
17804
  targetServer?: string;
17805
+ username?: string;
17625
17806
  static names(): {
17626
17807
  [key: string]: string;
17627
17808
  };
@@ -18621,6 +18802,19 @@ export declare class CreateAutoProvisioningGroupRequestSystemDiskConfig extends
18621
18802
  [key: string]: any;
18622
18803
  });
18623
18804
  }
18805
+ export declare class CreateAutoProvisioningGroupRequestTag extends $tea.Model {
18806
+ key?: string;
18807
+ value?: string;
18808
+ static names(): {
18809
+ [key: string]: string;
18810
+ };
18811
+ static types(): {
18812
+ [key: string]: any;
18813
+ };
18814
+ constructor(map?: {
18815
+ [key: string]: any;
18816
+ });
18817
+ }
18624
18818
  export declare class CreateAutoProvisioningGroupResponseBodyLaunchResultsLaunchResultInstanceIds extends $tea.Model {
18625
18819
  instanceId?: string[];
18626
18820
  static names(): {
@@ -18663,6 +18857,34 @@ export declare class CreateAutoProvisioningGroupResponseBodyLaunchResults extend
18663
18857
  [key: string]: any;
18664
18858
  });
18665
18859
  }
18860
+ export declare class CreateAutoSnapshotPolicyRequestCopyEncryptionConfigurationArn extends $tea.Model {
18861
+ assumeRoleFor?: number;
18862
+ roleType?: string;
18863
+ rolearn?: string;
18864
+ static names(): {
18865
+ [key: string]: string;
18866
+ };
18867
+ static types(): {
18868
+ [key: string]: any;
18869
+ };
18870
+ constructor(map?: {
18871
+ [key: string]: any;
18872
+ });
18873
+ }
18874
+ export declare class CreateAutoSnapshotPolicyRequestCopyEncryptionConfiguration extends $tea.Model {
18875
+ arn?: CreateAutoSnapshotPolicyRequestCopyEncryptionConfigurationArn[];
18876
+ encrypted?: boolean;
18877
+ KMSKeyId?: string;
18878
+ static names(): {
18879
+ [key: string]: string;
18880
+ };
18881
+ static types(): {
18882
+ [key: string]: any;
18883
+ };
18884
+ constructor(map?: {
18885
+ [key: string]: any;
18886
+ });
18887
+ }
18666
18888
  export declare class CreateAutoSnapshotPolicyRequestTag extends $tea.Model {
18667
18889
  key?: string;
18668
18890
  value?: string;
@@ -19769,6 +19991,19 @@ export declare class DescribeAutoProvisioningGroupInstancesResponseBodyInstances
19769
19991
  [key: string]: any;
19770
19992
  });
19771
19993
  }
19994
+ export declare class DescribeAutoProvisioningGroupsRequestTag extends $tea.Model {
19995
+ key?: string;
19996
+ value?: string;
19997
+ static names(): {
19998
+ [key: string]: string;
19999
+ };
20000
+ static types(): {
20001
+ [key: string]: any;
20002
+ };
20003
+ constructor(map?: {
20004
+ [key: string]: any;
20005
+ });
20006
+ }
19772
20007
  export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupLaunchTemplateConfigsLaunchTemplateConfig extends $tea.Model {
19773
20008
  instanceType?: string;
19774
20009
  maxPrice?: number;
@@ -19823,6 +20058,31 @@ export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningG
19823
20058
  [key: string]: any;
19824
20059
  });
19825
20060
  }
20061
+ export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTagsTag extends $tea.Model {
20062
+ tagKey?: string;
20063
+ tagValue?: string;
20064
+ static names(): {
20065
+ [key: string]: string;
20066
+ };
20067
+ static types(): {
20068
+ [key: string]: any;
20069
+ };
20070
+ constructor(map?: {
20071
+ [key: string]: any;
20072
+ });
20073
+ }
20074
+ export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTags extends $tea.Model {
20075
+ tag?: DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTagsTag[];
20076
+ static names(): {
20077
+ [key: string]: string;
20078
+ };
20079
+ static types(): {
20080
+ [key: string]: any;
20081
+ };
20082
+ constructor(map?: {
20083
+ [key: string]: any;
20084
+ });
20085
+ }
19826
20086
  export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTargetCapacitySpecification extends $tea.Model {
19827
20087
  defaultTargetCapacityType?: string;
19828
20088
  payAsYouGoTargetCapacity?: number;
@@ -19854,6 +20114,7 @@ export declare class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningG
19854
20114
  spotOptions?: DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupSpotOptions;
19855
20115
  state?: string;
19856
20116
  status?: string;
20117
+ tags?: DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTags;
19857
20118
  targetCapacitySpecification?: DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroupsAutoProvisioningGroupTargetCapacitySpecification;
19858
20119
  terminateInstances?: boolean;
19859
20120
  terminateInstancesWithExpiration?: boolean;
@@ -19894,6 +20155,19 @@ export declare class DescribeAutoSnapshotPolicyExRequestTag extends $tea.Model {
19894
20155
  [key: string]: any;
19895
20156
  });
19896
20157
  }
20158
+ export declare class DescribeAutoSnapshotPolicyExResponseBodyAutoSnapshotPoliciesAutoSnapshotPolicyCopyEncryptionConfiguration extends $tea.Model {
20159
+ encrypted?: boolean;
20160
+ KMSKeyId?: string;
20161
+ static names(): {
20162
+ [key: string]: string;
20163
+ };
20164
+ static types(): {
20165
+ [key: string]: any;
20166
+ };
20167
+ constructor(map?: {
20168
+ [key: string]: any;
20169
+ });
20170
+ }
19897
20171
  export declare class DescribeAutoSnapshotPolicyExResponseBodyAutoSnapshotPoliciesAutoSnapshotPolicyTagsTag extends $tea.Model {
19898
20172
  tagKey?: string;
19899
20173
  tagValue?: string;
@@ -19923,6 +20197,7 @@ export declare class DescribeAutoSnapshotPolicyExResponseBodyAutoSnapshotPolicie
19923
20197
  autoSnapshotPolicyId?: string;
19924
20198
  autoSnapshotPolicyName?: string;
19925
20199
  copiedSnapshotsRetentionDays?: number;
20200
+ copyEncryptionConfiguration?: DescribeAutoSnapshotPolicyExResponseBodyAutoSnapshotPoliciesAutoSnapshotPolicyCopyEncryptionConfiguration;
19926
20201
  creationTime?: string;
19927
20202
  diskNums?: number;
19928
20203
  enableCrossRegionCopy?: boolean;
@@ -20338,6 +20613,89 @@ export declare class DescribeClassicLinkInstancesResponseBodyLinks extends $tea.
20338
20613
  [key: string]: any;
20339
20614
  });
20340
20615
  }
20616
+ export declare class DescribeCloudAssistantSettingsResponseBodyAgentUpgradeConfigAllowedUpgradeWindows extends $tea.Model {
20617
+ allowedUpgradeWindow?: string[];
20618
+ static names(): {
20619
+ [key: string]: string;
20620
+ };
20621
+ static types(): {
20622
+ [key: string]: any;
20623
+ };
20624
+ constructor(map?: {
20625
+ [key: string]: any;
20626
+ });
20627
+ }
20628
+ export declare class DescribeCloudAssistantSettingsResponseBodyAgentUpgradeConfig extends $tea.Model {
20629
+ allowedUpgradeWindows?: DescribeCloudAssistantSettingsResponseBodyAgentUpgradeConfigAllowedUpgradeWindows;
20630
+ enabled?: boolean;
20631
+ timeZone?: string;
20632
+ static names(): {
20633
+ [key: string]: string;
20634
+ };
20635
+ static types(): {
20636
+ [key: string]: any;
20637
+ };
20638
+ constructor(map?: {
20639
+ [key: string]: any;
20640
+ });
20641
+ }
20642
+ export declare class DescribeCloudAssistantSettingsResponseBodyOssDeliveryConfigsOssDeliveryConfig extends $tea.Model {
20643
+ bucketName?: string;
20644
+ deliveryType?: string;
20645
+ enabled?: boolean;
20646
+ encryptionAlgorithm?: string;
20647
+ encryptionKeyId?: string;
20648
+ encryptionType?: string;
20649
+ prefix?: string;
20650
+ static names(): {
20651
+ [key: string]: string;
20652
+ };
20653
+ static types(): {
20654
+ [key: string]: any;
20655
+ };
20656
+ constructor(map?: {
20657
+ [key: string]: any;
20658
+ });
20659
+ }
20660
+ export declare class DescribeCloudAssistantSettingsResponseBodyOssDeliveryConfigs extends $tea.Model {
20661
+ ossDeliveryConfig?: DescribeCloudAssistantSettingsResponseBodyOssDeliveryConfigsOssDeliveryConfig[];
20662
+ static names(): {
20663
+ [key: string]: string;
20664
+ };
20665
+ static types(): {
20666
+ [key: string]: any;
20667
+ };
20668
+ constructor(map?: {
20669
+ [key: string]: any;
20670
+ });
20671
+ }
20672
+ export declare class DescribeCloudAssistantSettingsResponseBodySlsDeliveryConfigsSlsDeliveryConfig extends $tea.Model {
20673
+ deliveryType?: string;
20674
+ enabled?: boolean;
20675
+ logstoreName?: string;
20676
+ projectName?: string;
20677
+ static names(): {
20678
+ [key: string]: string;
20679
+ };
20680
+ static types(): {
20681
+ [key: string]: any;
20682
+ };
20683
+ constructor(map?: {
20684
+ [key: string]: any;
20685
+ });
20686
+ }
20687
+ export declare class DescribeCloudAssistantSettingsResponseBodySlsDeliveryConfigs extends $tea.Model {
20688
+ slsDeliveryConfig?: DescribeCloudAssistantSettingsResponseBodySlsDeliveryConfigsSlsDeliveryConfig[];
20689
+ static names(): {
20690
+ [key: string]: string;
20691
+ };
20692
+ static types(): {
20693
+ [key: string]: any;
20694
+ };
20695
+ constructor(map?: {
20696
+ [key: string]: any;
20697
+ });
20698
+ }
20341
20699
  export declare class DescribeCloudAssistantStatusResponseBodyInstanceCloudAssistantStatusSetInstanceCloudAssistantStatus extends $tea.Model {
20342
20700
  activeTaskCount?: number;
20343
20701
  cloudAssistantStatus?: string;
@@ -27268,6 +27626,66 @@ export declare class DescribeTasksResponseBodyTaskSet extends $tea.Model {
27268
27626
  [key: string]: any;
27269
27627
  });
27270
27628
  }
27629
+ export declare class DescribeTerminalSessionsResponseBodySessionsSessionConnectionsConnection extends $tea.Model {
27630
+ closedReason?: string;
27631
+ endTime?: string;
27632
+ instanceId?: string;
27633
+ startTime?: string;
27634
+ status?: string;
27635
+ static names(): {
27636
+ [key: string]: string;
27637
+ };
27638
+ static types(): {
27639
+ [key: string]: any;
27640
+ };
27641
+ constructor(map?: {
27642
+ [key: string]: any;
27643
+ });
27644
+ }
27645
+ export declare class DescribeTerminalSessionsResponseBodySessionsSessionConnections extends $tea.Model {
27646
+ connection?: DescribeTerminalSessionsResponseBodySessionsSessionConnectionsConnection[];
27647
+ static names(): {
27648
+ [key: string]: string;
27649
+ };
27650
+ static types(): {
27651
+ [key: string]: any;
27652
+ };
27653
+ constructor(map?: {
27654
+ [key: string]: any;
27655
+ });
27656
+ }
27657
+ export declare class DescribeTerminalSessionsResponseBodySessionsSession extends $tea.Model {
27658
+ clientIP?: string;
27659
+ connections?: DescribeTerminalSessionsResponseBodySessionsSessionConnections;
27660
+ creationTime?: string;
27661
+ identityType?: string;
27662
+ portNumber?: number;
27663
+ principalId?: string;
27664
+ sessionId?: string;
27665
+ targetServer?: string;
27666
+ username?: string;
27667
+ static names(): {
27668
+ [key: string]: string;
27669
+ };
27670
+ static types(): {
27671
+ [key: string]: any;
27672
+ };
27673
+ constructor(map?: {
27674
+ [key: string]: any;
27675
+ });
27676
+ }
27677
+ export declare class DescribeTerminalSessionsResponseBodySessions extends $tea.Model {
27678
+ session?: DescribeTerminalSessionsResponseBodySessionsSession[];
27679
+ static names(): {
27680
+ [key: string]: string;
27681
+ };
27682
+ static types(): {
27683
+ [key: string]: any;
27684
+ };
27685
+ constructor(map?: {
27686
+ [key: string]: any;
27687
+ });
27688
+ }
27271
27689
  export declare class DescribeVRoutersResponseBodyVRoutersVRouterRouteTableIds extends $tea.Model {
27272
27690
  routeTableId?: string[];
27273
27691
  static names(): {
@@ -28027,6 +28445,34 @@ export declare class ModifyAutoProvisioningGroupRequestLaunchTemplateConfig exte
28027
28445
  [key: string]: any;
28028
28446
  });
28029
28447
  }
28448
+ export declare class ModifyAutoSnapshotPolicyExRequestCopyEncryptionConfigurationArn extends $tea.Model {
28449
+ assumeRoleFor?: number;
28450
+ roleType?: string;
28451
+ rolearn?: string;
28452
+ static names(): {
28453
+ [key: string]: string;
28454
+ };
28455
+ static types(): {
28456
+ [key: string]: any;
28457
+ };
28458
+ constructor(map?: {
28459
+ [key: string]: any;
28460
+ });
28461
+ }
28462
+ export declare class ModifyAutoSnapshotPolicyExRequestCopyEncryptionConfiguration extends $tea.Model {
28463
+ arn?: ModifyAutoSnapshotPolicyExRequestCopyEncryptionConfigurationArn[];
28464
+ encrypted?: boolean;
28465
+ KMSKeyId?: string;
28466
+ static names(): {
28467
+ [key: string]: string;
28468
+ };
28469
+ static types(): {
28470
+ [key: string]: any;
28471
+ };
28472
+ constructor(map?: {
28473
+ [key: string]: any;
28474
+ });
28475
+ }
28030
28476
  export declare class ModifyCapacityReservationRequestPrivatePoolOptions extends $tea.Model {
28031
28477
  id?: string;
28032
28478
  name?: string;
@@ -28040,6 +28486,51 @@ export declare class ModifyCapacityReservationRequestPrivatePoolOptions extends
28040
28486
  [key: string]: any;
28041
28487
  });
28042
28488
  }
28489
+ export declare class ModifyCloudAssistantSettingsRequestAgentUpgradeConfig extends $tea.Model {
28490
+ allowedUpgradeWindow?: string[];
28491
+ enabled?: boolean;
28492
+ timeZone?: string;
28493
+ static names(): {
28494
+ [key: string]: string;
28495
+ };
28496
+ static types(): {
28497
+ [key: string]: any;
28498
+ };
28499
+ constructor(map?: {
28500
+ [key: string]: any;
28501
+ });
28502
+ }
28503
+ export declare class ModifyCloudAssistantSettingsRequestOssDeliveryConfig extends $tea.Model {
28504
+ bucketName?: string;
28505
+ enabled?: boolean;
28506
+ encryptionAlgorithm?: string;
28507
+ encryptionKeyId?: string;
28508
+ encryptionType?: string;
28509
+ prefix?: string;
28510
+ static names(): {
28511
+ [key: string]: string;
28512
+ };
28513
+ static types(): {
28514
+ [key: string]: any;
28515
+ };
28516
+ constructor(map?: {
28517
+ [key: string]: any;
28518
+ });
28519
+ }
28520
+ export declare class ModifyCloudAssistantSettingsRequestSlsDeliveryConfig extends $tea.Model {
28521
+ enabled?: boolean;
28522
+ logstoreName?: string;
28523
+ projectName?: string;
28524
+ static names(): {
28525
+ [key: string]: string;
28526
+ };
28527
+ static types(): {
28528
+ [key: string]: any;
28529
+ };
28530
+ constructor(map?: {
28531
+ [key: string]: any;
28532
+ });
28533
+ }
28043
28534
  export declare class ModifyDedicatedHostAttributeRequestNetworkAttributes extends $tea.Model {
28044
28535
  slbUdpTimeout?: number;
28045
28536
  udpTimeout?: number;
@@ -29550,13 +30041,14 @@ export default class Client extends OpenApi {
29550
30041
  */
29551
30042
  connectRouterInterface(request: ConnectRouterInterfaceRequest): Promise<ConnectRouterInterfaceResponse>;
29552
30043
  /**
29553
- * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
29554
- * When you call this operation, make sure that the following requirements are met:
29555
- * * The instance is in the `Stopped` or `Running` state.********
29556
- * * No EIPs are associated with the instance.
30044
+ * ## [](#)Usage notes
30045
+ * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you fully understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
30046
+ * When you call this operation, make sure that the ECS instance meets the following requirements:
30047
+ * * The instance is in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
30048
+ * * The instance has no EIPs associated.
29557
30049
  * * The instance has no configuration change tasks that have not taken effect.
29558
30050
  * * The public bandwidth of the instance is not 0 Mbit/s.
29559
- * * The instance uses the pay-by-traffic billing method for network usage.
30051
+ * * If the instance is a subscription instance, the billing method for network usage of the instance must be `pay-by-traffic`. The public IP address of a subscription instance that uses the `pay-by-bandwidth` billing method for network usage cannot be converted into an EIP. This requirement does not apply to pay-as-you-go instances. For more information, see [Change the billing method for network usage](~~178883~~).
29560
30052
  * * If the instance is a subscription instance that resides in a VPC, the instance does not expire within 24 hours.
29561
30053
  *
29562
30054
  * @param request ConvertNatPublicIpToEipRequest
@@ -29565,13 +30057,14 @@ export default class Client extends OpenApi {
29565
30057
  */
29566
30058
  convertNatPublicIpToEipWithOptions(request: ConvertNatPublicIpToEipRequest, runtime: $Util.RuntimeOptions): Promise<ConvertNatPublicIpToEipResponse>;
29567
30059
  /**
29568
- * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
29569
- * When you call this operation, make sure that the following requirements are met:
29570
- * * The instance is in the `Stopped` or `Running` state.********
29571
- * * No EIPs are associated with the instance.
30060
+ * ## [](#)Usage notes
30061
+ * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you fully understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
30062
+ * When you call this operation, make sure that the ECS instance meets the following requirements:
30063
+ * * The instance is in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
30064
+ * * The instance has no EIPs associated.
29572
30065
  * * The instance has no configuration change tasks that have not taken effect.
29573
30066
  * * The public bandwidth of the instance is not 0 Mbit/s.
29574
- * * The instance uses the pay-by-traffic billing method for network usage.
30067
+ * * If the instance is a subscription instance, the billing method for network usage of the instance must be `pay-by-traffic`. The public IP address of a subscription instance that uses the `pay-by-bandwidth` billing method for network usage cannot be converted into an EIP. This requirement does not apply to pay-as-you-go instances. For more information, see [Change the billing method for network usage](~~178883~~).
29575
30068
  * * If the instance is a subscription instance that resides in a VPC, the instance does not expire within 24 hours.
29576
30069
  *
29577
30070
  * @param request ConvertNatPublicIpToEipRequest
@@ -29666,10 +30159,10 @@ export default class Client extends OpenApi {
29666
30159
  */
29667
30160
  createActivation(request: CreateActivationRequest): Promise<CreateActivationResponse>;
29668
30161
  /**
29669
- * ## Usage notes
29670
- * * Auto Provisioning is a service that allows quick deployment of an instance cluster that consists of preemptible and pay-as-you-go instances. Auto Provisioning supports push-button deployment of instance clusters across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
30162
+ * ## [](#)Usage notes
30163
+ * * Auto Provisioning is a service that allows quick deployment of an instance cluster that consists of preemptible instances and pay-as-you-go instances. Auto Provisioning supports push-button deployment of instance clusters across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
29671
30164
  * * Auto Provisioning uses auto provisioning groups to schedule and maintain computing resources. You can use auto provisioning groups to obtain a steady supply of computing resources. This helps reduce the impact on compute capacity when preemptible instances are reclaimed.
29672
- * * Auto Provisioning is provided free-of-charge. However, you are charged for instance resources that are created in auto provisioning groups. For more information about the billing, see [Overview of preemptible instances](~~52088~~) and [Pay-as-you-go](~~40653~~).
30165
+ * * Auto Provisioning is provided free of charge. However, you are charged for instance resources that are created in auto provisioning groups. For more information, see [Overview of preemptible instances](~~52088~~) and [Pay-as-you-go](~~40653~~).
29673
30166
  * * When you specify both a launch template (`LaunchTemplateId`) and extended configurations (`LaunchConfiguration.*` parameters), LaunchTemplateId takes precedence.
29674
30167
  *
29675
30168
  * @param request CreateAutoProvisioningGroupRequest
@@ -29678,10 +30171,10 @@ export default class Client extends OpenApi {
29678
30171
  */
29679
30172
  createAutoProvisioningGroupWithOptions(request: CreateAutoProvisioningGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateAutoProvisioningGroupResponse>;
29680
30173
  /**
29681
- * ## Usage notes
29682
- * * Auto Provisioning is a service that allows quick deployment of an instance cluster that consists of preemptible and pay-as-you-go instances. Auto Provisioning supports push-button deployment of instance clusters across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
30174
+ * ## [](#)Usage notes
30175
+ * * Auto Provisioning is a service that allows quick deployment of an instance cluster that consists of preemptible instances and pay-as-you-go instances. Auto Provisioning supports push-button deployment of instance clusters across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
29683
30176
  * * Auto Provisioning uses auto provisioning groups to schedule and maintain computing resources. You can use auto provisioning groups to obtain a steady supply of computing resources. This helps reduce the impact on compute capacity when preemptible instances are reclaimed.
29684
- * * Auto Provisioning is provided free-of-charge. However, you are charged for instance resources that are created in auto provisioning groups. For more information about the billing, see [Overview of preemptible instances](~~52088~~) and [Pay-as-you-go](~~40653~~).
30177
+ * * Auto Provisioning is provided free of charge. However, you are charged for instance resources that are created in auto provisioning groups. For more information, see [Overview of preemptible instances](~~52088~~) and [Pay-as-you-go](~~40653~~).
29685
30178
  * * When you specify both a launch template (`LaunchTemplateId`) and extended configurations (`LaunchConfiguration.*` parameters), LaunchTemplateId takes precedence.
29686
30179
  *
29687
30180
  * @param request CreateAutoProvisioningGroupRequest
@@ -29689,11 +30182,12 @@ export default class Client extends OpenApi {
29689
30182
  */
29690
30183
  createAutoProvisioningGroup(request: CreateAutoProvisioningGroupRequest): Promise<CreateAutoProvisioningGroupResponse>;
29691
30184
  /**
29692
- * When you call this operation to create an automatic snapshot policy, you can specify the days of the week on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the policy to meet your diverse data backup requirements. After you create an automatic snapshot policy, you must call the [ApplyAutoSnapshotPolicy](~~25531~~) operation to apply it to disks. If you want to modify the automatic snapshot policy, you must call the [ModifyAutoSnapshotPolicyEx](~~25529~~) operation.
30185
+ * ## [](#)Usage notes
30186
+ * When you call this operation to create an automatic snapshot policy, you can specify the days of the week on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the policy to meet your diverse data backup requirements. After the automatic snapshot policy is created, call the [ApplyAutoSnapshotPolicy](~~25531~~) operation to apply the policy to disks. If you want to modify the automatic snapshot policy, call the [ModifyAutoSnapshotPolicyEx](~~25529~~) operation.
29693
30187
  * Take note of the following items:
29694
- * * You can create a maximum of 100 automatic snapshot policies per region for a single Alibaba Cloud account.
29695
- * * If an automatic snapshot is being created when the time scheduled for creating another automatic snapshot is due, the new snapshot task is skipped. This may occur when a disk contains a large volume of data. For example, you have scheduled snapshots to be created at 09:00:00, 10:00:00, 11:00:00, and 12:00:00 for a disk. The system starts to create a snapshot for the disk at 09:00:00. The process takes 80 minutes to complete because the disk contains a large volume of data and ends at 10:20:00. The system skips the automatic snapshot task scheduled for 10:00:00 and creates the next automatic snapshot for the disk at 11:00:00.
29696
- * * For information about how to copy a snapshot from one region to another, see the "Background information" section in [Copy a snapshot](~~159441~~).
30188
+ * * You can create up to 100 automatic snapshot policies per region for a single Alibaba Cloud account.
30189
+ * * If an automatic snapshot is being created when the time scheduled for creating another automatic snapshot is due, the new snapshot task is skipped. This may occur when a disk contains a large volume of data. For example, you have scheduled snapshots to be created at 09:00:00, 10:00:00, 11:00:00, and 12:00:00 for a disk. The system starts to create a snapshot for the disk at 09:00:00. The process takes 80 minutes to complete because the disk contains a large volume of data and ends at 10:20:00. In this case, the system does not create a snapshot at 10:00, but creates a snapshot at 11:00.
30190
+ * * For information about how to copy a snapshot from one region to another region, see the "Background information" section in [Copy a snapshot](~~159441~~).
29697
30191
  *
29698
30192
  * @param request CreateAutoSnapshotPolicyRequest
29699
30193
  * @param runtime runtime options for this request RuntimeOptions
@@ -29701,11 +30195,12 @@ export default class Client extends OpenApi {
29701
30195
  */
29702
30196
  createAutoSnapshotPolicyWithOptions(request: CreateAutoSnapshotPolicyRequest, runtime: $Util.RuntimeOptions): Promise<CreateAutoSnapshotPolicyResponse>;
29703
30197
  /**
29704
- * When you call this operation to create an automatic snapshot policy, you can specify the days of the week on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the policy to meet your diverse data backup requirements. After you create an automatic snapshot policy, you must call the [ApplyAutoSnapshotPolicy](~~25531~~) operation to apply it to disks. If you want to modify the automatic snapshot policy, you must call the [ModifyAutoSnapshotPolicyEx](~~25529~~) operation.
30198
+ * ## [](#)Usage notes
30199
+ * When you call this operation to create an automatic snapshot policy, you can specify the days of the week on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the policy to meet your diverse data backup requirements. After the automatic snapshot policy is created, call the [ApplyAutoSnapshotPolicy](~~25531~~) operation to apply the policy to disks. If you want to modify the automatic snapshot policy, call the [ModifyAutoSnapshotPolicyEx](~~25529~~) operation.
29705
30200
  * Take note of the following items:
29706
- * * You can create a maximum of 100 automatic snapshot policies per region for a single Alibaba Cloud account.
29707
- * * If an automatic snapshot is being created when the time scheduled for creating another automatic snapshot is due, the new snapshot task is skipped. This may occur when a disk contains a large volume of data. For example, you have scheduled snapshots to be created at 09:00:00, 10:00:00, 11:00:00, and 12:00:00 for a disk. The system starts to create a snapshot for the disk at 09:00:00. The process takes 80 minutes to complete because the disk contains a large volume of data and ends at 10:20:00. The system skips the automatic snapshot task scheduled for 10:00:00 and creates the next automatic snapshot for the disk at 11:00:00.
29708
- * * For information about how to copy a snapshot from one region to another, see the "Background information" section in [Copy a snapshot](~~159441~~).
30201
+ * * You can create up to 100 automatic snapshot policies per region for a single Alibaba Cloud account.
30202
+ * * If an automatic snapshot is being created when the time scheduled for creating another automatic snapshot is due, the new snapshot task is skipped. This may occur when a disk contains a large volume of data. For example, you have scheduled snapshots to be created at 09:00:00, 10:00:00, 11:00:00, and 12:00:00 for a disk. The system starts to create a snapshot for the disk at 09:00:00. The process takes 80 minutes to complete because the disk contains a large volume of data and ends at 10:20:00. In this case, the system does not create a snapshot at 10:00, but creates a snapshot at 11:00.
30203
+ * * For information about how to copy a snapshot from one region to another region, see the "Background information" section in [Copy a snapshot](~~159441~~).
29709
30204
  *
29710
30205
  * @param request CreateAutoSnapshotPolicyRequest
29711
30206
  * @return CreateAutoSnapshotPolicyResponse
@@ -29976,42 +30471,44 @@ export default class Client extends OpenApi {
29976
30471
  */
29977
30472
  createImagePipeline(request: CreateImagePipelineRequest): Promise<CreateImagePipelineResponse>;
29978
30473
  /**
29979
- * > You can call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone. If you want to batch create instances that automatically enter the Running state after they are created, we recommend that you call the [RunInstances](~~63440~~) operation.
29980
- * When you call this operation, take note of the following items:
29981
- * * **Billing**:
29982
- * * You must fully understand the ECS billing methods before you create an instance because you may be charged for resources used by the instance. For more information, see [Billing overview](~~25398~~).
29983
- * * If you create a subscription instance (`PrePaid`), available coupons within your account are used by default.
29984
- * * **Instance type**:
29985
- * * You can use the `IoOptimized` parameter to specify whether to create an I/O optimized instance.
29986
- * * Select an instance type. See [Instance families](~~25378~~) or call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of an instance type, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
29987
- * * Query available resources. Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
29988
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, it indicates that you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
29989
- * * **Image**:
29990
- * * The image determines the system disk configurations of the new instance. The system disk of the new instance is a clone of the specified image.
29991
- * * If you want to create instances with 512 MiB of memory, you cannot use Windows Server images except for Windows Server Semi-Annual Channel images.
29992
- * * If you want to create instances with 4 GiB or more of memory, you cannot use 32-bit OS image.
29993
- * * **Network type**:
29994
- * * Each instance that resides in a virtual private cloud (VPC) must be connected to only a single vSwitch.
29995
- * * If the `VSwitchId` parameter is specified, the security group specified by `SecurityGroupId` and the vSwitch specified by `VSwitchId` must belong to the same VPC.
29996
- * * The value of `PrivateIpAddress` depends on that of `VSwitchId` and cannot be separately specified.`` If both the `VSwitchId` and `PrivateIpAddress` parameters are specified, the IP address specified by `PrivateIpAddress` must be available in the CIDR block of the specified vSwitch.
29997
- * * **Public bandwidth**:
29998
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
29999
- * * If you call the `CreateInstance` operation to create an instance, no public IP addresses are assigned to the instance. You can call the [AllocatePublicIpAddress](~~25544~~) operation to manually assign public IP addresses to instances.
30000
- * * Network usage fees are determined based on the settings of `InternetChargeType` and `InternetMaxBandwidthOut`.
30001
- * * The `InternetMaxBandwidthIn` value is irrelevant to billing because inbound data traffic is free of charge.
30002
- * * If `InternetChargeType` is set to PayByBandwidth, `InternetMaxBandwidthOut` specifies the fixed bandwidth value. A fixed bandwidth is a specified amount of public bandwidth allocated to an instance that uses the pay-by-bandwidth billing method for network usage.
30003
- * * If `InternetChargeType` is set to PayByTraffic, `InternetMaxBandwidthOut` specifies the peak bandwidth value. A peak bandwidth is the maximum amount of public bandwidth that an instance can consume when it uses the pay-by-traffic billing method for network usage. Network usage costs are calculated based on the volume of network traffic.
30004
- * * **Security group**:
30005
- * * If no security groups are available in the region where you want to create an instance, you must call the [CreateSecurityGroup](~~25553~~) operation to create a security group in that region first.
30006
- * * The maximum number of instances that a security group can contain varies based on the security group type. For more information, see the "Security group limits" section in [Limits](~~25412~~).
30007
- * * Instances in the same security group can communicate with each other over the internal network. By default, instances in different security groups cannot communicate with each other. You can allow communication between instances by allowing mutual access between their security groups. For more information, see [AuthorizeSecurityGroup](~~25554~~) and [AuthorizeSecurityGroupEgress](~~25560~~).
30008
- * * **Storage**:
30009
- * * The instance is assigned a system disk whose size is determined based on the specified image. The size of the system disk must be at least `20 GiB` and greater than or equal to the image size. For more information about system disk categories, see the description of the `SystemDisk.Category` parameter.
30010
- * * The system disk of an I/O optimized instance can only be an enhanced SSD (ESSD) (`cloud_essd`), a standard SSD (`cloud_ssd`), or an ultra disk (`cloud_efficiency`).
30011
- * * The maximum size of a data disk varies based on its category. For more information, see the description of the `DataDisk.N.Size` parameter.
30012
- * * A maximum of 16 data disks can be attached to each instance. The mount points of data disks are allocated by the system in alphabetical order from /dev/xvdb to /dev/xvdz.
30013
- * * **User data**: If the instance type supports [user data](~~49121~~), you can use the UserData parameter to pass in user data. User data is encoded in Base64. We recommend that you do not pass in confidential information (such as passwords or private keys) in plaintext as user data. This is because the system does not encrypt `UserData` values when API requests are transmitted. If you must pass in confidential information, we recommend that you encrypt and encode the information in Base64 and then decode and decrypt the information in the same way within the instance.
30014
- * * **Others**: When you call API operations by using Alibaba Cloud CLI or SDKs, you must delete periods (.) from some request parameters before you use the parameters. For example, use `SystemDiskCategory` instead of `SystemDisk.Category` as a request parameter.
30474
+ * ## [](#)Usage notes
30475
+ * > You can call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone. If you want to batch create instances that automatically enter the Running state after they are created, we recommend that you call the [RunInstances](~~63440~~) operation.
30476
+ * Take note of the following items:
30477
+ * * **Billing**:
30478
+ * * You must familiarize yourself with ECS billing methods before you create an instance because you may be charged for the resources used by the instance. For more information, see [Billing overview](~~25398~~).
30479
+ * * If you create a subscription instance (`PrePaid`), available coupons in your account are used by default.
30480
+ * * **Instance type**:
30481
+ * * You can use the `IoOptimized` parameter to specify whether to create an I/O optimized instance.
30482
+ * * Instance type selection: See [Instance families](~~25378~~) or call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
30483
+ * * Query of available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query resources available in a specific region or zone.
30484
+ * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, it indicates that the maximum number of instances of the specified instance type in the region has been reached, or the maximum number of vCPUs for all instance types in a zone has been reached. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
30485
+ * * **Image**:
30486
+ * * The image determines the system disk configurations of the new instance. The system disk of the new instance is a clone of the specified image.
30487
+ * * If you want to create instances with 512 MiB of memory, you cannot use Windows Server images except for Windows Server Semi-Annual Channel images.
30488
+ * * If you want to create instances with 4 GiB or more of memory, you cannot use 32-bit OS image.
30489
+ * * **Network type**:
30490
+ * * Each instance that resides in a virtual private cloud (VPC) must be connected to only a single vSwitch.
30491
+ * * If `VSwitchId` is specified, the security group specified by `SecurityGroupId` and the vSwitch specified by `VSwitchId` must belong to the same VPC.
30492
+ * * The value of `PrivateIpAddress` varies based on the value of `VSwitchId`. `PrivateIpAddress` cannot be separately specified. If `VSwitchId` and `PrivateIpAddress` are specified, the IP address specified by `PrivateIpAddress` must be an idle IP address in the CIDR block of the specified vSwitch.
30493
+ * * **Public bandwidth**:
30494
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the bandwidth limit, submit a ticket. The throttling policy imposes the following constraints: In a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
30495
+ * * If you call the `CreateInstance` operation to create an instance, no public IP addresses are assigned to the instance. You can call the [AllocatePublicIpAddress](~~25544~~) operation to assign a public IP address to an instance.
30496
+ * * Network usage fees vary based on the settings of `InternetChargeType` and `InternetMaxBandwidthOut`.
30497
+ * * The value of `InternetMaxBandwidthIn` does not affect billing because inbound data traffic is free of charge.
30498
+ * * If `InternetChargeType` is set to PayByBandwidth, `InternetMaxBandwidthOut` specifies the fixed bandwidth. A fixed bandwidth is a specified amount of public bandwidth allocated to an instance that uses the pay-by-bandwidth billing method for network usage.
30499
+ * * If `InternetChargeType` is set to PayByTraffic, `InternetMaxBandwidthOut` specifies the peak bandwidth. A peak bandwidth is the maximum amount of public bandwidth that an instance can consume when the instance uses the pay-by-traffic billing method for network usage. Network usage costs are calculated based on the volume of network traffic.
30500
+ * * **Security group**:
30501
+ * * If no security groups are available in the region where you want to create an instance, you must call the [CreateSecurityGroup](~~25553~~) operation to create a security group in that region first.
30502
+ * * The maximum number of instances that a security group can contain varies based on the security group type. For more information, see the "Security group limits" section in the [Limits](~~25412~~) topic.
30503
+ * * Instances in the same security group can communicate with each other over the internal network. By default, instances in different security groups cannot communicate with each other. You can allow communication between instances by allowing mutual access between the security groups to which the instances belong. For more information, see [AuthorizeSecurityGroup](~~25554~~) and [AuthorizeSecurityGroupEgress](~~25560~~).
30504
+ * * **Storage**:
30505
+ * * The instance is assigned a system disk whose capacity varies based on the size of the specified image. The size of the system disk must be at least `20 GiB` and greater than or equal to the image size. For information about system disk categories, see the description of `SystemDisk.Category`.
30506
+ * * The system disk of an I/O optimized instance can only be an enhanced SSD (ESSD) (`cloud_essd`), a standard SSD (`cloud_ssd`), or an ultra disk (`cloud_efficiency`).
30507
+ * * The maximum size of a data disk varies based on the disk category. For more information, see the description of `DataDisk.N.Size`.
30508
+ * * Up to 16 data disks can be added to an instance. Mount points /dev/xvd\\[b-z] are automatically assigned to data disks in ascending alphanumeric order.
30509
+ * > If the `QuotaExceed.DiskCapacity` error is returned when you call this operation, it indicates that the maximum capacity of the disks of the selected disk category in the specified zone has been reached. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to query and request a quota increase.
30510
+ * * **User data**: If the instance type supports user data, you can use the UserData parameter to pass in user data.[](~~49121~~) User data is encoded in Base64. We recommend that you do not pass in confidential information (such as passwords or private keys) in plaintext as user data. This is because the system does not encrypt `UserData` values when API requests are transmitted. If you must pass in confidential information, we recommend that you encrypt and encode the information in Base64 before you pass in the information. Then decode and decrypt the information in the same way within the instance.
30511
+ * * **Others**: When you call API operations by using Alibaba Cloud CLI or SDKs, you must delete periods (.) from some request parameters before you use the parameters. For example, use `SystemDiskCategory` instead of `SystemDisk.Category` as a request parameter.
30015
30512
  *
30016
30513
  * @param request CreateInstanceRequest
30017
30514
  * @param runtime runtime options for this request RuntimeOptions
@@ -30019,42 +30516,44 @@ export default class Client extends OpenApi {
30019
30516
  */
30020
30517
  createInstanceWithOptions(request: CreateInstanceRequest, runtime: $Util.RuntimeOptions): Promise<CreateInstanceResponse>;
30021
30518
  /**
30022
- * > You can call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone. If you want to batch create instances that automatically enter the Running state after they are created, we recommend that you call the [RunInstances](~~63440~~) operation.
30023
- * When you call this operation, take note of the following items:
30024
- * * **Billing**:
30025
- * * You must fully understand the ECS billing methods before you create an instance because you may be charged for resources used by the instance. For more information, see [Billing overview](~~25398~~).
30026
- * * If you create a subscription instance (`PrePaid`), available coupons within your account are used by default.
30027
- * * **Instance type**:
30028
- * * You can use the `IoOptimized` parameter to specify whether to create an I/O optimized instance.
30029
- * * Select an instance type. See [Instance families](~~25378~~) or call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of an instance type, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
30030
- * * Query available resources. Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
30031
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, it indicates that you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
30032
- * * **Image**:
30033
- * * The image determines the system disk configurations of the new instance. The system disk of the new instance is a clone of the specified image.
30034
- * * If you want to create instances with 512 MiB of memory, you cannot use Windows Server images except for Windows Server Semi-Annual Channel images.
30035
- * * If you want to create instances with 4 GiB or more of memory, you cannot use 32-bit OS image.
30036
- * * **Network type**:
30037
- * * Each instance that resides in a virtual private cloud (VPC) must be connected to only a single vSwitch.
30038
- * * If the `VSwitchId` parameter is specified, the security group specified by `SecurityGroupId` and the vSwitch specified by `VSwitchId` must belong to the same VPC.
30039
- * * The value of `PrivateIpAddress` depends on that of `VSwitchId` and cannot be separately specified.`` If both the `VSwitchId` and `PrivateIpAddress` parameters are specified, the IP address specified by `PrivateIpAddress` must be available in the CIDR block of the specified vSwitch.
30040
- * * **Public bandwidth**:
30041
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
30042
- * * If you call the `CreateInstance` operation to create an instance, no public IP addresses are assigned to the instance. You can call the [AllocatePublicIpAddress](~~25544~~) operation to manually assign public IP addresses to instances.
30043
- * * Network usage fees are determined based on the settings of `InternetChargeType` and `InternetMaxBandwidthOut`.
30044
- * * The `InternetMaxBandwidthIn` value is irrelevant to billing because inbound data traffic is free of charge.
30045
- * * If `InternetChargeType` is set to PayByBandwidth, `InternetMaxBandwidthOut` specifies the fixed bandwidth value. A fixed bandwidth is a specified amount of public bandwidth allocated to an instance that uses the pay-by-bandwidth billing method for network usage.
30046
- * * If `InternetChargeType` is set to PayByTraffic, `InternetMaxBandwidthOut` specifies the peak bandwidth value. A peak bandwidth is the maximum amount of public bandwidth that an instance can consume when it uses the pay-by-traffic billing method for network usage. Network usage costs are calculated based on the volume of network traffic.
30047
- * * **Security group**:
30048
- * * If no security groups are available in the region where you want to create an instance, you must call the [CreateSecurityGroup](~~25553~~) operation to create a security group in that region first.
30049
- * * The maximum number of instances that a security group can contain varies based on the security group type. For more information, see the "Security group limits" section in [Limits](~~25412~~).
30050
- * * Instances in the same security group can communicate with each other over the internal network. By default, instances in different security groups cannot communicate with each other. You can allow communication between instances by allowing mutual access between their security groups. For more information, see [AuthorizeSecurityGroup](~~25554~~) and [AuthorizeSecurityGroupEgress](~~25560~~).
30051
- * * **Storage**:
30052
- * * The instance is assigned a system disk whose size is determined based on the specified image. The size of the system disk must be at least `20 GiB` and greater than or equal to the image size. For more information about system disk categories, see the description of the `SystemDisk.Category` parameter.
30053
- * * The system disk of an I/O optimized instance can only be an enhanced SSD (ESSD) (`cloud_essd`), a standard SSD (`cloud_ssd`), or an ultra disk (`cloud_efficiency`).
30054
- * * The maximum size of a data disk varies based on its category. For more information, see the description of the `DataDisk.N.Size` parameter.
30055
- * * A maximum of 16 data disks can be attached to each instance. The mount points of data disks are allocated by the system in alphabetical order from /dev/xvdb to /dev/xvdz.
30056
- * * **User data**: If the instance type supports [user data](~~49121~~), you can use the UserData parameter to pass in user data. User data is encoded in Base64. We recommend that you do not pass in confidential information (such as passwords or private keys) in plaintext as user data. This is because the system does not encrypt `UserData` values when API requests are transmitted. If you must pass in confidential information, we recommend that you encrypt and encode the information in Base64 and then decode and decrypt the information in the same way within the instance.
30057
- * * **Others**: When you call API operations by using Alibaba Cloud CLI or SDKs, you must delete periods (.) from some request parameters before you use the parameters. For example, use `SystemDiskCategory` instead of `SystemDisk.Category` as a request parameter.
30519
+ * ## [](#)Usage notes
30520
+ * > You can call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone. If you want to batch create instances that automatically enter the Running state after they are created, we recommend that you call the [RunInstances](~~63440~~) operation.
30521
+ * Take note of the following items:
30522
+ * * **Billing**:
30523
+ * * You must familiarize yourself with ECS billing methods before you create an instance because you may be charged for the resources used by the instance. For more information, see [Billing overview](~~25398~~).
30524
+ * * If you create a subscription instance (`PrePaid`), available coupons in your account are used by default.
30525
+ * * **Instance type**:
30526
+ * * You can use the `IoOptimized` parameter to specify whether to create an I/O optimized instance.
30527
+ * * Instance type selection: See [Instance families](~~25378~~) or call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
30528
+ * * Query of available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query resources available in a specific region or zone.
30529
+ * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, it indicates that the maximum number of instances of the specified instance type in the region has been reached, or the maximum number of vCPUs for all instance types in a zone has been reached. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
30530
+ * * **Image**:
30531
+ * * The image determines the system disk configurations of the new instance. The system disk of the new instance is a clone of the specified image.
30532
+ * * If you want to create instances with 512 MiB of memory, you cannot use Windows Server images except for Windows Server Semi-Annual Channel images.
30533
+ * * If you want to create instances with 4 GiB or more of memory, you cannot use 32-bit OS image.
30534
+ * * **Network type**:
30535
+ * * Each instance that resides in a virtual private cloud (VPC) must be connected to only a single vSwitch.
30536
+ * * If `VSwitchId` is specified, the security group specified by `SecurityGroupId` and the vSwitch specified by `VSwitchId` must belong to the same VPC.
30537
+ * * The value of `PrivateIpAddress` varies based on the value of `VSwitchId`. `PrivateIpAddress` cannot be separately specified. If `VSwitchId` and `PrivateIpAddress` are specified, the IP address specified by `PrivateIpAddress` must be an idle IP address in the CIDR block of the specified vSwitch.
30538
+ * * **Public bandwidth**:
30539
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the bandwidth limit, submit a ticket. The throttling policy imposes the following constraints: In a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
30540
+ * * If you call the `CreateInstance` operation to create an instance, no public IP addresses are assigned to the instance. You can call the [AllocatePublicIpAddress](~~25544~~) operation to assign a public IP address to an instance.
30541
+ * * Network usage fees vary based on the settings of `InternetChargeType` and `InternetMaxBandwidthOut`.
30542
+ * * The value of `InternetMaxBandwidthIn` does not affect billing because inbound data traffic is free of charge.
30543
+ * * If `InternetChargeType` is set to PayByBandwidth, `InternetMaxBandwidthOut` specifies the fixed bandwidth. A fixed bandwidth is a specified amount of public bandwidth allocated to an instance that uses the pay-by-bandwidth billing method for network usage.
30544
+ * * If `InternetChargeType` is set to PayByTraffic, `InternetMaxBandwidthOut` specifies the peak bandwidth. A peak bandwidth is the maximum amount of public bandwidth that an instance can consume when the instance uses the pay-by-traffic billing method for network usage. Network usage costs are calculated based on the volume of network traffic.
30545
+ * * **Security group**:
30546
+ * * If no security groups are available in the region where you want to create an instance, you must call the [CreateSecurityGroup](~~25553~~) operation to create a security group in that region first.
30547
+ * * The maximum number of instances that a security group can contain varies based on the security group type. For more information, see the "Security group limits" section in the [Limits](~~25412~~) topic.
30548
+ * * Instances in the same security group can communicate with each other over the internal network. By default, instances in different security groups cannot communicate with each other. You can allow communication between instances by allowing mutual access between the security groups to which the instances belong. For more information, see [AuthorizeSecurityGroup](~~25554~~) and [AuthorizeSecurityGroupEgress](~~25560~~).
30549
+ * * **Storage**:
30550
+ * * The instance is assigned a system disk whose capacity varies based on the size of the specified image. The size of the system disk must be at least `20 GiB` and greater than or equal to the image size. For information about system disk categories, see the description of `SystemDisk.Category`.
30551
+ * * The system disk of an I/O optimized instance can only be an enhanced SSD (ESSD) (`cloud_essd`), a standard SSD (`cloud_ssd`), or an ultra disk (`cloud_efficiency`).
30552
+ * * The maximum size of a data disk varies based on the disk category. For more information, see the description of `DataDisk.N.Size`.
30553
+ * * Up to 16 data disks can be added to an instance. Mount points /dev/xvd\\[b-z] are automatically assigned to data disks in ascending alphanumeric order.
30554
+ * > If the `QuotaExceed.DiskCapacity` error is returned when you call this operation, it indicates that the maximum capacity of the disks of the selected disk category in the specified zone has been reached. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to query and request a quota increase.
30555
+ * * **User data**: If the instance type supports user data, you can use the UserData parameter to pass in user data.[](~~49121~~) User data is encoded in Base64. We recommend that you do not pass in confidential information (such as passwords or private keys) in plaintext as user data. This is because the system does not encrypt `UserData` values when API requests are transmitted. If you must pass in confidential information, we recommend that you encrypt and encode the information in Base64 before you pass in the information. Then decode and decrypt the information in the same way within the instance.
30556
+ * * **Others**: When you call API operations by using Alibaba Cloud CLI or SDKs, you must delete periods (.) from some request parameters before you use the parameters. For example, use `SystemDiskCategory` instead of `SystemDisk.Category` as a request parameter.
30058
30557
  *
30059
30558
  * @param request CreateInstanceRequest
30060
30559
  * @return CreateInstanceResponse
@@ -30137,16 +30636,15 @@ export default class Client extends OpenApi {
30137
30636
  */
30138
30637
  createNatGateway(request: CreateNatGatewayRequest): Promise<CreateNatGatewayResponse>;
30139
30638
  /**
30140
- * ## Usage notes
30639
+ * ## [](#)Usage notes
30141
30640
  * Take note of the following items:
30142
- * * CreateNetworkInterface is a synchronous operation. After an ENI is created, the ENI immediately enters the Available state and can be attached to an Elastic Compute Service (ECS) instance.
30641
+ * * This operation is a synchronous operation. After an ENI is created, it immediately enters the Available (`Available`) state and can be attached to an Elastic Compute Service (ECS) instance.
30143
30642
  * * If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
30144
30643
  * * An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
30145
30644
  * * When an ENI is detached from an instance and attached to another instance, the attributes of the ENI remain unchanged and network traffic is redirected to the new instance.
30146
- * * When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
30147
- * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 has been enabled for the vSwitch with which to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30645
+ * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 is enabled for the vSwitch with which you want to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30148
30646
  * * A quota is imposed on the number of ENIs that can be created per Alibaba Cloud region per account. You can view the quota in the ECS console. For more information, see [View and increase resource quotas](~~184115~~).
30149
- * **For information about examples on how to call this operation, see **[Create an ENI](~~471552~~).
30647
+ * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
30150
30648
  *
30151
30649
  * @param request CreateNetworkInterfaceRequest
30152
30650
  * @param runtime runtime options for this request RuntimeOptions
@@ -30154,16 +30652,15 @@ export default class Client extends OpenApi {
30154
30652
  */
30155
30653
  createNetworkInterfaceWithOptions(request: CreateNetworkInterfaceRequest, runtime: $Util.RuntimeOptions): Promise<CreateNetworkInterfaceResponse>;
30156
30654
  /**
30157
- * ## Usage notes
30655
+ * ## [](#)Usage notes
30158
30656
  * Take note of the following items:
30159
- * * CreateNetworkInterface is a synchronous operation. After an ENI is created, the ENI immediately enters the Available state and can be attached to an Elastic Compute Service (ECS) instance.
30657
+ * * This operation is a synchronous operation. After an ENI is created, it immediately enters the Available (`Available`) state and can be attached to an Elastic Compute Service (ECS) instance.
30160
30658
  * * If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
30161
30659
  * * An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
30162
30660
  * * When an ENI is detached from an instance and attached to another instance, the attributes of the ENI remain unchanged and network traffic is redirected to the new instance.
30163
- * * When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
30164
- * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 has been enabled for the vSwitch with which to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30661
+ * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 is enabled for the vSwitch with which you want to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30165
30662
  * * A quota is imposed on the number of ENIs that can be created per Alibaba Cloud region per account. You can view the quota in the ECS console. For more information, see [View and increase resource quotas](~~184115~~).
30166
- * **For information about examples on how to call this operation, see **[Create an ENI](~~471552~~).
30663
+ * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
30167
30664
  *
30168
30665
  * @param request CreateNetworkInterfaceRequest
30169
30666
  * @return CreateNetworkInterfaceResponse
@@ -30187,7 +30684,13 @@ export default class Client extends OpenApi {
30187
30684
  */
30188
30685
  createPhysicalConnection(request: CreatePhysicalConnectionRequest): Promise<CreatePhysicalConnectionResponse>;
30189
30686
  /**
30190
- * PrefixListNameSample
30687
+ * * A prefix list is a collection of network prefixes (CIDR blocks) and can be referenced to configure network rules for other resources. For more information, see [Overview](~~206223~~).
30688
+ * * When you create a prefix list, take note of the following items:
30689
+ * * You must specify an IP address family (IPv4 or IPv6) for the prefix list, and cannot change the IP address family after the prefix list is created. You cannot combine IPv4 and IPv6 CIDR blocks in a single prefix list.
30690
+ * * You must specify the maximum number of entries that the prefix list can contain. You cannot modify the maximum number of entries after the prefix list is created.
30691
+ * * You can specify entries for the prefix list. Each entry consists of a CIDR block and the description for the CIDR block. The total number of entries cannot exceed the maximum number of entries that you specified.
30692
+ * * For more information about the limits on prefix lists and other resources, see [Limits](~~25412~~).
30693
+ * * You can create Resource Access Management (RAM) users and grant them minimum permissions. This eliminates the need to share the AccessKey pair of your Alibaba Cloud account with other users and reduces security risks for your enterprises. For information about how to grant permissions on prefix lists to RAM users, see [Grant a RAM user permissions on prefix lists](~~206175~~)
30191
30694
  *
30192
30695
  * @param request CreatePrefixListRequest
30193
30696
  * @param runtime runtime options for this request RuntimeOptions
@@ -30195,7 +30698,13 @@ export default class Client extends OpenApi {
30195
30698
  */
30196
30699
  createPrefixListWithOptions(request: CreatePrefixListRequest, runtime: $Util.RuntimeOptions): Promise<CreatePrefixListResponse>;
30197
30700
  /**
30198
- * PrefixListNameSample
30701
+ * * A prefix list is a collection of network prefixes (CIDR blocks) and can be referenced to configure network rules for other resources. For more information, see [Overview](~~206223~~).
30702
+ * * When you create a prefix list, take note of the following items:
30703
+ * * You must specify an IP address family (IPv4 or IPv6) for the prefix list, and cannot change the IP address family after the prefix list is created. You cannot combine IPv4 and IPv6 CIDR blocks in a single prefix list.
30704
+ * * You must specify the maximum number of entries that the prefix list can contain. You cannot modify the maximum number of entries after the prefix list is created.
30705
+ * * You can specify entries for the prefix list. Each entry consists of a CIDR block and the description for the CIDR block. The total number of entries cannot exceed the maximum number of entries that you specified.
30706
+ * * For more information about the limits on prefix lists and other resources, see [Limits](~~25412~~).
30707
+ * * You can create Resource Access Management (RAM) users and grant them minimum permissions. This eliminates the need to share the AccessKey pair of your Alibaba Cloud account with other users and reduces security risks for your enterprises. For information about how to grant permissions on prefix lists to RAM users, see [Grant a RAM user permissions on prefix lists](~~206175~~)
30199
30708
  *
30200
30709
  * @param request CreatePrefixListRequest
30201
30710
  * @return CreatePrefixListResponse
@@ -30278,7 +30787,20 @@ export default class Client extends OpenApi {
30278
30787
  */
30279
30788
  createSimulatedSystemEvents(request: CreateSimulatedSystemEventsRequest): Promise<CreateSimulatedSystemEventsResponse>;
30280
30789
  /**
30281
- * The request ID.
30790
+ * ## [](#)Usage notes
30791
+ * The local snapshot feature is replaced by the instant access feature. Take note of the following items:
30792
+ * * If you have used the local snapshot feature before December 14, 2020, you can use the Category parameter.
30793
+ * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your enhanced SSDs (ESSDs) at performance levels 0, 1, 2, and 3 (PL0, PL1, PL2, and PL3 ESSDs) and ESSD AutoPL disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters in this operation that are related to the instant access feature no longer take effect. Available is added to the response parameters of the DescribeSnapshots and DescribeSnapshotGroup operations to indicate whether the snapshot is available.
30794
+ * In the following scenarios, you cannot create snapshots for a disk:
30795
+ * * The number of manual snapshots of the disk has reached 256.
30796
+ * * A snapshot is being created for the disk.
30797
+ * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
30798
+ * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
30799
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
30800
+ * When you create a snapshot, take note of the following items:
30801
+ * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](~~25535~~) operation.
30802
+ * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
30803
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating` state and is deleted when the disk is released.
30282
30804
  *
30283
30805
  * @param request CreateSnapshotRequest
30284
30806
  * @param runtime runtime options for this request RuntimeOptions
@@ -30286,23 +30808,37 @@ export default class Client extends OpenApi {
30286
30808
  */
30287
30809
  createSnapshotWithOptions(request: CreateSnapshotRequest, runtime: $Util.RuntimeOptions): Promise<CreateSnapshotResponse>;
30288
30810
  /**
30289
- * The request ID.
30811
+ * ## [](#)Usage notes
30812
+ * The local snapshot feature is replaced by the instant access feature. Take note of the following items:
30813
+ * * If you have used the local snapshot feature before December 14, 2020, you can use the Category parameter.
30814
+ * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your enhanced SSDs (ESSDs) at performance levels 0, 1, 2, and 3 (PL0, PL1, PL2, and PL3 ESSDs) and ESSD AutoPL disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters in this operation that are related to the instant access feature no longer take effect. Available is added to the response parameters of the DescribeSnapshots and DescribeSnapshotGroup operations to indicate whether the snapshot is available.
30815
+ * In the following scenarios, you cannot create snapshots for a disk:
30816
+ * * The number of manual snapshots of the disk has reached 256.
30817
+ * * A snapshot is being created for the disk.
30818
+ * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
30819
+ * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
30820
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
30821
+ * When you create a snapshot, take note of the following items:
30822
+ * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](~~25535~~) operation.
30823
+ * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
30824
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating` state and is deleted when the disk is released.
30290
30825
  *
30291
30826
  * @param request CreateSnapshotRequest
30292
30827
  * @return CreateSnapshotResponse
30293
30828
  */
30294
30829
  createSnapshot(request: CreateSnapshotRequest): Promise<CreateSnapshotResponse>;
30295
30830
  /**
30296
- * You can specify `InstanceId` to create a snapshot-consistent group for the specified cloud disks of an instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple cloud disks that are attached to multiple instances within the same zone.
30297
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is set, you can use `DiskId.N` to specify only cloud disks attached to the instance specified by InstanceId. You cannot use DiskId.N to specify cloud disks attached to multiple instances.
30298
- * When you call this operation, take note of the following items:
30299
- * * The cloud disk for which you want to create a snapshot must be in the **In Use** or **Unattached** (`Available`) state.``
30300
- * * If the cloud disk is in the **In Use** state, the instance to which the cloud disk is attached must be in the **Running** or **Stopped** state.``````
30301
- * * If the cloud disk is in the **Unattached** (`Available`) state, make sure that the cloud disk has been attached to an ECS instance. Snapshots cannot be created for cloud disks that have never been attached to an ECS instance.
30302
- * * The snapshot-consistent group feature can be used to create snapshots only for enhanced SSDs (ESSDs).
30303
- * * A snapshot-consistent group can contain snapshots of up to 16 cloud disks (including the system disk and data disks) whose total disk size does not exceed 32 TiB.
30304
- * * Snapshots that you created by using the snapshot-consistent group feature are retained until they are deleted. We recommend that you delete unnecessary snapshots on a regular basis to prevent them from incurring excess fees.
30305
- * * Snapshot-consistent groups cannot be created for cloud disks that have the multi-attach feature enabled. If cloud disks for which the multi-attach feature is enabled are attached to an instance, you must set `ExcludeDiskId.N` to exclude these cloud disks.
30831
+ * ## [](#)Usage notes
30832
+ * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific (ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
30833
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is specified, you can use `DiskId.N` to specify only disks on the ECS instance specified by InstanceId and cannot use DiskId.N to specify disks across ECS instances.
30834
+ * Take note of the following items:
30835
+ * * The disks for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
30836
+ * * If a disk is in the **In Use** (`In_use`) state, make sure that the ECS instance to which the disk is attached is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
30837
+ * * If a disk is in the **Unattached** (`Available`) state, make sure that the disk has been attached to ECS instances. Snapshots cannot be created for disks that have never been attached to an ECS instance.
30838
+ * * Snapshot-consistent groups can be used to create snapshots only for enhanced SSDs (ESSDs).
30839
+ * * A snapshot-consistent group can contain snapshots of up to 16 disks, including system disks and data disks, and cannot exceed 32 TiB in size.
30840
+ * * Snapshots that you created are stored indefinitely until you delete the snapshots. We recommend that you delete unnecessary snapshots on a regular basis to prevent excess snapshot storage fees.
30841
+ * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, specify the `ExcludeDiskId.N` parameter to exclude the disks.
30306
30842
  * For more information about the snapshot-consistent group feature, see [Create a snapshot-consistent group](~~199625~~).
30307
30843
  *
30308
30844
  * @param request CreateSnapshotGroupRequest
@@ -30311,16 +30847,17 @@ export default class Client extends OpenApi {
30311
30847
  */
30312
30848
  createSnapshotGroupWithOptions(request: CreateSnapshotGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateSnapshotGroupResponse>;
30313
30849
  /**
30314
- * You can specify `InstanceId` to create a snapshot-consistent group for the specified cloud disks of an instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple cloud disks that are attached to multiple instances within the same zone.
30315
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is set, you can use `DiskId.N` to specify only cloud disks attached to the instance specified by InstanceId. You cannot use DiskId.N to specify cloud disks attached to multiple instances.
30316
- * When you call this operation, take note of the following items:
30317
- * * The cloud disk for which you want to create a snapshot must be in the **In Use** or **Unattached** (`Available`) state.``
30318
- * * If the cloud disk is in the **In Use** state, the instance to which the cloud disk is attached must be in the **Running** or **Stopped** state.``````
30319
- * * If the cloud disk is in the **Unattached** (`Available`) state, make sure that the cloud disk has been attached to an ECS instance. Snapshots cannot be created for cloud disks that have never been attached to an ECS instance.
30320
- * * The snapshot-consistent group feature can be used to create snapshots only for enhanced SSDs (ESSDs).
30321
- * * A snapshot-consistent group can contain snapshots of up to 16 cloud disks (including the system disk and data disks) whose total disk size does not exceed 32 TiB.
30322
- * * Snapshots that you created by using the snapshot-consistent group feature are retained until they are deleted. We recommend that you delete unnecessary snapshots on a regular basis to prevent them from incurring excess fees.
30323
- * * Snapshot-consistent groups cannot be created for cloud disks that have the multi-attach feature enabled. If cloud disks for which the multi-attach feature is enabled are attached to an instance, you must set `ExcludeDiskId.N` to exclude these cloud disks.
30850
+ * ## [](#)Usage notes
30851
+ * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific (ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
30852
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is specified, you can use `DiskId.N` to specify only disks on the ECS instance specified by InstanceId and cannot use DiskId.N to specify disks across ECS instances.
30853
+ * Take note of the following items:
30854
+ * * The disks for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
30855
+ * * If a disk is in the **In Use** (`In_use`) state, make sure that the ECS instance to which the disk is attached is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
30856
+ * * If a disk is in the **Unattached** (`Available`) state, make sure that the disk has been attached to ECS instances. Snapshots cannot be created for disks that have never been attached to an ECS instance.
30857
+ * * Snapshot-consistent groups can be used to create snapshots only for enhanced SSDs (ESSDs).
30858
+ * * A snapshot-consistent group can contain snapshots of up to 16 disks, including system disks and data disks, and cannot exceed 32 TiB in size.
30859
+ * * Snapshots that you created are stored indefinitely until you delete the snapshots. We recommend that you delete unnecessary snapshots on a regular basis to prevent excess snapshot storage fees.
30860
+ * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, specify the `ExcludeDiskId.N` parameter to exclude the disks.
30324
30861
  * For more information about the snapshot-consistent group feature, see [Create a snapshot-consistent group](~~199625~~).
30325
30862
  *
30326
30863
  * @param request CreateSnapshotGroupRequest
@@ -30572,14 +31109,15 @@ export default class Client extends OpenApi {
30572
31109
  */
30573
31110
  deleteImagePipeline(request: DeleteImagePipelineRequest): Promise<DeleteImagePipelineResponse>;
30574
31111
  /**
30575
- * * After an instance is released, all the physical resources used by the instance are reclaimed by Alibaba Cloud. Data stored on the instance is deleted permanently and cannot be restored.
30576
- * * Disk settings may affect their behavior when the instances they are attached to are released. Take note of the following items:
30577
- * * If `DeleteWithInstance` is set to false, the disks are retained as pay-as-you-go disks.
30578
- * * If `DeleteWithInstance` is set to true, the disks are released along with the instance.
30579
- * * If `DeleteAutoSnapshot` is set to false, automatic snapshots of the disks are retained.
30580
- * * If `DeleteAutoSnapshot` is set to true, automatic snapshots of the disks are released.
31112
+ * ## [](#)Usage notes
31113
+ * * After an ECS instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be restored.
31114
+ * * When you release an ECS instance, take note of the following items for the disks attached to the instance:
31115
+ * * The disks for which `DeleteWithInstance` is set to false are retained as pay-as-you-go disks after the instance is released.
31116
+ * * The disks for which `DeleteWithInstance` is set to true are released along with the instance.
31117
+ * * For disks for which `DeleteAutoSnapshot` is set to false, the automatic snapshots of the disks are retained after the instance is released.
31118
+ * * For disks for which `DeleteAutoSnapshot` is set to true, the automatic snapshots of the disks are released along with the instance.
30581
31119
  * * Manual snapshots of the disks are retained.
30582
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. In this case, even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, the parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).``
31120
+ * * If `OperationLocks` in the response contains `"LockReason" : "security"` when you query the information of the instance, the instance is locked for security reasons. In this case, even if `DeleteWithInstance` is set to `false` for the disks that are attached to the instance, the system ignores the DeleteWithInstance value and releases the disks along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30583
31121
  *
30584
31122
  * @param request DeleteInstanceRequest
30585
31123
  * @param runtime runtime options for this request RuntimeOptions
@@ -30587,14 +31125,15 @@ export default class Client extends OpenApi {
30587
31125
  */
30588
31126
  deleteInstanceWithOptions(request: DeleteInstanceRequest, runtime: $Util.RuntimeOptions): Promise<DeleteInstanceResponse>;
30589
31127
  /**
30590
- * * After an instance is released, all the physical resources used by the instance are reclaimed by Alibaba Cloud. Data stored on the instance is deleted permanently and cannot be restored.
30591
- * * Disk settings may affect their behavior when the instances they are attached to are released. Take note of the following items:
30592
- * * If `DeleteWithInstance` is set to false, the disks are retained as pay-as-you-go disks.
30593
- * * If `DeleteWithInstance` is set to true, the disks are released along with the instance.
30594
- * * If `DeleteAutoSnapshot` is set to false, automatic snapshots of the disks are retained.
30595
- * * If `DeleteAutoSnapshot` is set to true, automatic snapshots of the disks are released.
31128
+ * ## [](#)Usage notes
31129
+ * * After an ECS instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be restored.
31130
+ * * When you release an ECS instance, take note of the following items for the disks attached to the instance:
31131
+ * * The disks for which `DeleteWithInstance` is set to false are retained as pay-as-you-go disks after the instance is released.
31132
+ * * The disks for which `DeleteWithInstance` is set to true are released along with the instance.
31133
+ * * For disks for which `DeleteAutoSnapshot` is set to false, the automatic snapshots of the disks are retained after the instance is released.
31134
+ * * For disks for which `DeleteAutoSnapshot` is set to true, the automatic snapshots of the disks are released along with the instance.
30596
31135
  * * Manual snapshots of the disks are retained.
30597
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. In this case, even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, the parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).``
31136
+ * * If `OperationLocks` in the response contains `"LockReason" : "security"` when you query the information of the instance, the instance is locked for security reasons. In this case, even if `DeleteWithInstance` is set to `false` for the disks that are attached to the instance, the system ignores the DeleteWithInstance value and releases the disks along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30598
31137
  *
30599
31138
  * @param request DeleteInstanceRequest
30600
31139
  * @return DeleteInstanceResponse
@@ -30668,15 +31207,17 @@ export default class Client extends OpenApi {
30668
31207
  */
30669
31208
  deleteNatGateway(request: DeleteNatGatewayRequest): Promise<DeleteNatGatewayResponse>;
30670
31209
  /**
30671
- * ##
30672
- * * The ENI must be in the Available state.
30673
- * * If the ENI is attached to an Elastic Compute Service (ECS) instance, you must call [DetachNetworkInterface](~~58514~~) to detach the ENI from the instance before you can delete the ENI.
31210
+ * Take note of the following items:
31211
+ * * The ENI to be deleted must be in the Available state.
31212
+ * * If the ENI to be deleted is attached to an Elastic Compute Service (ECS) instance, you must detach the ENI from the instance before you can delete the ENI. To detach the ENI, you can call the [DetachNetworkInterface](~~58514~~) operation.
30674
31213
  * * After an ENI is deleted, the following situations occur:
30675
- * * All the private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
30676
- * * The ENI is automatically removed from its security groups.
30677
- * * This operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the state or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.
30678
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221208/xual/DeleteNetworkInterface.jpg) - If the ENI is in the Deleting state, the ENI deletion request is sent, and the ENI is being deleted. - If the ENI is not found, the ENI is deleted. - If the ENI is stuck in the Deleting state, the ENI fails to be deleted, and you can re-initiate the request to delete the ENI.
30679
- * **For information about examples on how to call this operation, see **[Delete an ENI](~~471553~~).
31214
+ * * All private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
31215
+ * * The ENI is automatically removed from all security groups.
31216
+ * * The DeleteNetworkInterface operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the status or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221208/xual/DeleteNetworkInterface.jpg)
31217
+ * * If the ENI is in the Deleting state, the ENI deletion request is sent and the ENI is being deleted.
31218
+ * * If the ENI is not found, the ENI is deleted.
31219
+ * * If the ENI is stuck in the Deleting state, the ENI fails to be deleted. You can re-initiate the request to delete the ENI.
31220
+ * **For information about examples on how to call the DeleteNetworkInterface operation, see **[Delete an ENI](~~471553~~).
30680
31221
  *
30681
31222
  * @param request DeleteNetworkInterfaceRequest
30682
31223
  * @param runtime runtime options for this request RuntimeOptions
@@ -30684,15 +31225,17 @@ export default class Client extends OpenApi {
30684
31225
  */
30685
31226
  deleteNetworkInterfaceWithOptions(request: DeleteNetworkInterfaceRequest, runtime: $Util.RuntimeOptions): Promise<DeleteNetworkInterfaceResponse>;
30686
31227
  /**
30687
- * ##
30688
- * * The ENI must be in the Available state.
30689
- * * If the ENI is attached to an Elastic Compute Service (ECS) instance, you must call [DetachNetworkInterface](~~58514~~) to detach the ENI from the instance before you can delete the ENI.
31228
+ * Take note of the following items:
31229
+ * * The ENI to be deleted must be in the Available state.
31230
+ * * If the ENI to be deleted is attached to an Elastic Compute Service (ECS) instance, you must detach the ENI from the instance before you can delete the ENI. To detach the ENI, you can call the [DetachNetworkInterface](~~58514~~) operation.
30690
31231
  * * After an ENI is deleted, the following situations occur:
30691
- * * All the private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
30692
- * * The ENI is automatically removed from its security groups.
30693
- * * This operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the state or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.
30694
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221208/xual/DeleteNetworkInterface.jpg) - If the ENI is in the Deleting state, the ENI deletion request is sent, and the ENI is being deleted. - If the ENI is not found, the ENI is deleted. - If the ENI is stuck in the Deleting state, the ENI fails to be deleted, and you can re-initiate the request to delete the ENI.
30695
- * **For information about examples on how to call this operation, see **[Delete an ENI](~~471553~~).
31232
+ * * All private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
31233
+ * * The ENI is automatically removed from all security groups.
31234
+ * * The DeleteNetworkInterface operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the status or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221208/xual/DeleteNetworkInterface.jpg)
31235
+ * * If the ENI is in the Deleting state, the ENI deletion request is sent and the ENI is being deleted.
31236
+ * * If the ENI is not found, the ENI is deleted.
31237
+ * * If the ENI is stuck in the Deleting state, the ENI fails to be deleted. You can re-initiate the request to delete the ENI.
31238
+ * **For information about examples on how to call the DeleteNetworkInterface operation, see **[Delete an ENI](~~471553~~).
30696
31239
  *
30697
31240
  * @param request DeleteNetworkInterfaceRequest
30698
31241
  * @return DeleteNetworkInterfaceResponse
@@ -30729,7 +31272,7 @@ export default class Client extends OpenApi {
30729
31272
  */
30730
31273
  deletePhysicalConnection(request: DeletePhysicalConnectionRequest): Promise<DeletePhysicalConnectionResponse>;
30731
31274
  /**
30732
- * The region ID of the prefix list. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list.
31275
+ * If a prefix list is associated with resources, you cannot delete the prefix list. You must disassociate the prefix list from the resources before you delete the prefix list. You can call the [DescribePrefixListAssociations](~~204724~~) operation to query resources that are associated with a specific prefix list.
30733
31276
  *
30734
31277
  * @param request DeletePrefixListRequest
30735
31278
  * @param runtime runtime options for this request RuntimeOptions
@@ -30737,7 +31280,7 @@ export default class Client extends OpenApi {
30737
31280
  */
30738
31281
  deletePrefixListWithOptions(request: DeletePrefixListRequest, runtime: $Util.RuntimeOptions): Promise<DeletePrefixListResponse>;
30739
31282
  /**
30740
- * The region ID of the prefix list. You can call the [DescribeRegions](~~25609~~) operation to query the most recent region list.
31283
+ * If a prefix list is associated with resources, you cannot delete the prefix list. You must disassociate the prefix list from the resources before you delete the prefix list. You can call the [DescribePrefixListAssociations](~~204724~~) operation to query resources that are associated with a specific prefix list.
30741
31284
  *
30742
31285
  * @param request DeletePrefixListRequest
30743
31286
  * @return DeletePrefixListResponse
@@ -30774,8 +31317,10 @@ export default class Client extends OpenApi {
30774
31317
  */
30775
31318
  deleteRouterInterface(request: DeleteRouterInterfaceRequest): Promise<DeleteRouterInterfaceResponse>;
30776
31319
  /**
30777
- * - Before you delete a security group, make sure that the security group does not contain instances and is not referenced by other security groups. Otherwise, the DeleteSecurityGroup request fails. You can call the [DescribeSecurityGroupReferences](~~57320~~) operation to query the reference details of the security group.
30778
- * - If the error code InvalidOperation.DeletionProtection is returned when you call the DeleteSecurityGroup operation to delete a security group or if a deletion protection-related message appears when you delete a security group in the console, the deletion protection feature is enabled for the security group. When you create a Container Service for Kubernetes (ACK) cluster, the deletion protection feature is enabled for an associated security group to prevent accidental deletion. You cannot manually disable the deletion protection feature for the security group. The deletion protection feature can be automatically disabled only after the ACK cluster is deleted. For more information, see [Disable deletion protection for a security group](~~353191~~)
31320
+ * ## [](#)Usage notes
31321
+ * Take note of the following items:
31322
+ * * Before you delete a security group, make sure that the security group does not contain instances and is not referenced by other security groups. Otherwise, the DeleteSecurityGroup request fails. You can call the [DescribeSecurityGroupReferences](~~57320~~) operation to query the reference details of the security group.
31323
+ * * If the InvalidOperation.DeletionProtection error code is returned when you call the DeleteSecurityGroup operation to delete a security group or if a deletion protection-related message appears when you delete a security group in the Elastic Compute Service (ECS) console, the deletion protection feature is enabled for the security group. When you create a Container Service for Kubernetes (ACK) cluster, the deletion protection feature is enabled for an associated security group to prevent accidental deletion. You cannot manually disable the deletion protection feature for the security group. The deletion protection feature can be automatically disabled only after the ACK cluster is deleted. For more information, see [Disable deletion protection for a security group](~~353191~~).
30779
31324
  *
30780
31325
  * @param request DeleteSecurityGroupRequest
30781
31326
  * @param runtime runtime options for this request RuntimeOptions
@@ -30783,8 +31328,10 @@ export default class Client extends OpenApi {
30783
31328
  */
30784
31329
  deleteSecurityGroupWithOptions(request: DeleteSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<DeleteSecurityGroupResponse>;
30785
31330
  /**
30786
- * - Before you delete a security group, make sure that the security group does not contain instances and is not referenced by other security groups. Otherwise, the DeleteSecurityGroup request fails. You can call the [DescribeSecurityGroupReferences](~~57320~~) operation to query the reference details of the security group.
30787
- * - If the error code InvalidOperation.DeletionProtection is returned when you call the DeleteSecurityGroup operation to delete a security group or if a deletion protection-related message appears when you delete a security group in the console, the deletion protection feature is enabled for the security group. When you create a Container Service for Kubernetes (ACK) cluster, the deletion protection feature is enabled for an associated security group to prevent accidental deletion. You cannot manually disable the deletion protection feature for the security group. The deletion protection feature can be automatically disabled only after the ACK cluster is deleted. For more information, see [Disable deletion protection for a security group](~~353191~~)
31331
+ * ## [](#)Usage notes
31332
+ * Take note of the following items:
31333
+ * * Before you delete a security group, make sure that the security group does not contain instances and is not referenced by other security groups. Otherwise, the DeleteSecurityGroup request fails. You can call the [DescribeSecurityGroupReferences](~~57320~~) operation to query the reference details of the security group.
31334
+ * * If the InvalidOperation.DeletionProtection error code is returned when you call the DeleteSecurityGroup operation to delete a security group or if a deletion protection-related message appears when you delete a security group in the Elastic Compute Service (ECS) console, the deletion protection feature is enabled for the security group. When you create a Container Service for Kubernetes (ACK) cluster, the deletion protection feature is enabled for an associated security group to prevent accidental deletion. You cannot manually disable the deletion protection feature for the security group. The deletion protection feature can be automatically disabled only after the ACK cluster is deleted. For more information, see [Disable deletion protection for a security group](~~353191~~).
30788
31335
  *
30789
31336
  * @param request DeleteSecurityGroupRequest
30790
31337
  * @return DeleteSecurityGroupResponse
@@ -30892,7 +31439,7 @@ export default class Client extends OpenApi {
30892
31439
  describeAccessPoints(request: DescribeAccessPointsRequest): Promise<DescribeAccessPointsResponse>;
30893
31440
  /**
30894
31441
  * After you [create](https://account.alibabacloud.com/register/intl_register.htm) an Alibaba Cloud account, you can create a specific number of ECS instances in different regions within the account. For more information, see [Limits](~~25412~~).
30895
- * You can apply for a quota increase in the [Quota Center console](https://ecs.console.aliyun.com/?#/privilegeQuotaV2/region/cn-hangzhou?subTab=userQuota).
31442
+ * You can apply for a quota increase in the [Quota Center console](https://quotas.console.aliyun.com/products).
30896
31443
  *
30897
31444
  * @param request DescribeAccountAttributesRequest
30898
31445
  * @param runtime runtime options for this request RuntimeOptions
@@ -30901,7 +31448,7 @@ export default class Client extends OpenApi {
30901
31448
  describeAccountAttributesWithOptions(request: DescribeAccountAttributesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeAccountAttributesResponse>;
30902
31449
  /**
30903
31450
  * After you [create](https://account.alibabacloud.com/register/intl_register.htm) an Alibaba Cloud account, you can create a specific number of ECS instances in different regions within the account. For more information, see [Limits](~~25412~~).
30904
- * You can apply for a quota increase in the [Quota Center console](https://ecs.console.aliyun.com/?#/privilegeQuotaV2/region/cn-hangzhou?subTab=userQuota).
31451
+ * You can apply for a quota increase in the [Quota Center console](https://quotas.console.aliyun.com/products).
30905
31452
  *
30906
31453
  * @param request DescribeAccountAttributesRequest
30907
31454
  * @return DescribeAccountAttributesResponse
@@ -31005,6 +31552,8 @@ export default class Client extends OpenApi {
31005
31552
  * @return DescribeClassicLinkInstancesResponse
31006
31553
  */
31007
31554
  describeClassicLinkInstances(request: DescribeClassicLinkInstancesRequest): Promise<DescribeClassicLinkInstancesResponse>;
31555
+ describeCloudAssistantSettingsWithOptions(request: DescribeCloudAssistantSettingsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeCloudAssistantSettingsResponse>;
31556
+ describeCloudAssistantSettings(request: DescribeCloudAssistantSettingsRequest): Promise<DescribeCloudAssistantSettingsResponse>;
31008
31557
  /**
31009
31558
  * - Before you run commands on or send files to instances, especially new instances, we recommend that you query the status of Cloud Assistant on the instances by calling this operation and checking the return value of CloudAssistantStatus. Run commands on or send files to the instances only when the return value is true.
31010
31559
  * - You can use one of the following methods to check the responses:
@@ -31149,13 +31698,14 @@ export default class Client extends OpenApi {
31149
31698
  describeDiagnosticReportsWithOptions(request: DescribeDiagnosticReportsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDiagnosticReportsResponse>;
31150
31699
  describeDiagnosticReports(request: DescribeDiagnosticReportsRequest): Promise<DescribeDiagnosticReportsResponse>;
31151
31700
  /**
31152
- * The monitoring data includes read IOPS, write IOPS, read bandwidth (byte/s), write bandwidth (byte/s), read latency (microseconds), and write latency (microseconds) of the disk.
31153
- * When you call this operation, take note of the following items:
31154
- * * Only the monitoring data of disks that are in the Running (`In_use`) state can be queried. For more information, see [Disk states](~~25689~~).
31701
+ * ## [](#)Usage notes
31702
+ * You can query the following monitoring data of a disk: the read IOPS, write IOPS, read bandwidth (byte/s), write bandwidth (byte/s), read latency (microseconds), and write latency (microseconds).
31703
+ * Take note of the following items:
31704
+ * * You can query the monitoring data only of the disks that are in the In Use (`In_Use`) state. For more information, see [Disk states](~~25689~~).
31155
31705
  * **
31156
- * **Note**Some information may be missing from the monitoring data of a disk because the disk is not in the In Use (`In_Use`) state and the system cannot obtain the relevant information.
31157
- * * A maximum of 400 monitoring data entries can be returned at a time. An error is returned if the value calculated based on the following formula is greater than 400: `(EndTime - StartTime)/Period`.
31158
- * * You can query the monitoring data in a maximum of the last 30 days. If the value of `StartTime` is greater than 30 days before the current time, an error is returned.
31706
+ * **Note** Some information may be missing from the monitoring data of a disk because the disk is not in the In Use (`In_Use`) state and the system cannot obtain the relevant information.
31707
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
31708
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
31159
31709
  *
31160
31710
  * @param request DescribeDiskMonitorDataRequest
31161
31711
  * @param runtime runtime options for this request RuntimeOptions
@@ -31163,27 +31713,29 @@ export default class Client extends OpenApi {
31163
31713
  */
31164
31714
  describeDiskMonitorDataWithOptions(request: DescribeDiskMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDiskMonitorDataResponse>;
31165
31715
  /**
31166
- * The monitoring data includes read IOPS, write IOPS, read bandwidth (byte/s), write bandwidth (byte/s), read latency (microseconds), and write latency (microseconds) of the disk.
31167
- * When you call this operation, take note of the following items:
31168
- * * Only the monitoring data of disks that are in the Running (`In_use`) state can be queried. For more information, see [Disk states](~~25689~~).
31716
+ * ## [](#)Usage notes
31717
+ * You can query the following monitoring data of a disk: the read IOPS, write IOPS, read bandwidth (byte/s), write bandwidth (byte/s), read latency (microseconds), and write latency (microseconds).
31718
+ * Take note of the following items:
31719
+ * * You can query the monitoring data only of the disks that are in the In Use (`In_Use`) state. For more information, see [Disk states](~~25689~~).
31169
31720
  * **
31170
- * **Note**Some information may be missing from the monitoring data of a disk because the disk is not in the In Use (`In_Use`) state and the system cannot obtain the relevant information.
31171
- * * A maximum of 400 monitoring data entries can be returned at a time. An error is returned if the value calculated based on the following formula is greater than 400: `(EndTime - StartTime)/Period`.
31172
- * * You can query the monitoring data in a maximum of the last 30 days. If the value of `StartTime` is greater than 30 days before the current time, an error is returned.
31721
+ * **Note** Some information may be missing from the monitoring data of a disk because the disk is not in the In Use (`In_Use`) state and the system cannot obtain the relevant information.
31722
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
31723
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
31173
31724
  *
31174
31725
  * @param request DescribeDiskMonitorDataRequest
31175
31726
  * @return DescribeDiskMonitorDataResponse
31176
31727
  */
31177
31728
  describeDiskMonitorData(request: DescribeDiskMonitorDataRequest): Promise<DescribeDiskMonitorDataResponse>;
31178
31729
  /**
31179
- * * You can specify multiple request parameters such as `RegionId`, `ZoneId`, `DiskIds`, and `InstanceId` as filters. Specified parameters are evaluated by using the "AND" operator. If you specify more than one filter, the records that match all filters are returned.
31180
- * * The value of the `DiskIds` parameter is a JSON array. If it is not specified, it is not used as a filter, and if `DiskIds` is set to an empty JSON array, it is regarded as a valid filter, and an empty result is returned.
31730
+ * ### [](#)Usage notes
31731
+ * * You can specify multiple request parameters such as `RegionId`, `ZoneId`, `DiskIds`, and `InstanceId` as filters. The specified parameters are evaluated by using the "AND" operator. If you specify more than one filter, the records that match all filters are returned.
31732
+ * * The value of `DiskIds` is a JSON array. If you do not specify DiskIds, the parameter is not used as a filter condition. If you set `DiskIds` to an empty JSON array, the parameter is regarded as a valid filter, and an empty result is returned.
31181
31733
  * * You can use one of the following methods to check the responses:
31182
- * * Method 1: Use `NextToken` to configure the query token. Set the value to the `NextToken` value that was returned in the last call made to the DescribeDisks operation. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
31183
- * * Method 2: Use `PageSize` to specify the number of entries to return on each page and then use `PageNumber` to specify the page number to return.
31184
- * You can use only one of the preceding methods. If you require a large number of entries to be returned, we recommend that you use method 1. If `NextToken` is specified, `PageSize` and `PageNumber` do not take effect and `TotalCount` in the response is invalid.
31185
- * * A disk that has the multi-attach feature enabled can be attached to multiple instances. You can query the attachment information of the disk based on the `Attachment` values in the response.
31186
- * When you call an API operation by using Alibaba Cloud CLI, you must specify the request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31734
+ * * Method 1: Use `NextToken` to specify the pagination token. Set the value to the `NextToken` value that is obtained from the previous query. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
31735
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page, and then use `PageNumber` to specify the number of the page to return.
31736
+ * You can use only one of the preceding methods. If a large number of entries are to be returned, we recommend that you use Method 1. If `NextToken` is specified, `PageSize` and `PageNumber` do not take effect and `TotalCount` in the response is invalid.
31737
+ * * You can attach a disk for which the multi-attach feature is enabled to multiple instances. You can query the attachment information of the disk based on the `Attachment` values in the response.
31738
+ * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31187
31739
  *
31188
31740
  * @param request DescribeDisksRequest
31189
31741
  * @param runtime runtime options for this request RuntimeOptions
@@ -31191,14 +31743,15 @@ export default class Client extends OpenApi {
31191
31743
  */
31192
31744
  describeDisksWithOptions(request: DescribeDisksRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDisksResponse>;
31193
31745
  /**
31194
- * * You can specify multiple request parameters such as `RegionId`, `ZoneId`, `DiskIds`, and `InstanceId` as filters. Specified parameters are evaluated by using the "AND" operator. If you specify more than one filter, the records that match all filters are returned.
31195
- * * The value of the `DiskIds` parameter is a JSON array. If it is not specified, it is not used as a filter, and if `DiskIds` is set to an empty JSON array, it is regarded as a valid filter, and an empty result is returned.
31746
+ * ### [](#)Usage notes
31747
+ * * You can specify multiple request parameters such as `RegionId`, `ZoneId`, `DiskIds`, and `InstanceId` as filters. The specified parameters are evaluated by using the "AND" operator. If you specify more than one filter, the records that match all filters are returned.
31748
+ * * The value of `DiskIds` is a JSON array. If you do not specify DiskIds, the parameter is not used as a filter condition. If you set `DiskIds` to an empty JSON array, the parameter is regarded as a valid filter, and an empty result is returned.
31196
31749
  * * You can use one of the following methods to check the responses:
31197
- * * Method 1: Use `NextToken` to configure the query token. Set the value to the `NextToken` value that was returned in the last call made to the DescribeDisks operation. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
31198
- * * Method 2: Use `PageSize` to specify the number of entries to return on each page and then use `PageNumber` to specify the page number to return.
31199
- * You can use only one of the preceding methods. If you require a large number of entries to be returned, we recommend that you use method 1. If `NextToken` is specified, `PageSize` and `PageNumber` do not take effect and `TotalCount` in the response is invalid.
31200
- * * A disk that has the multi-attach feature enabled can be attached to multiple instances. You can query the attachment information of the disk based on the `Attachment` values in the response.
31201
- * When you call an API operation by using Alibaba Cloud CLI, you must specify the request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31750
+ * * Method 1: Use `NextToken` to specify the pagination token. Set the value to the `NextToken` value that is obtained from the previous query. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
31751
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page, and then use `PageNumber` to specify the number of the page to return.
31752
+ * You can use only one of the preceding methods. If a large number of entries are to be returned, we recommend that you use Method 1. If `NextToken` is specified, `PageSize` and `PageNumber` do not take effect and `TotalCount` in the response is invalid.
31753
+ * * You can attach a disk for which the multi-attach feature is enabled to multiple instances. You can query the attachment information of the disk based on the `Attachment` values in the response.
31754
+ * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31202
31755
  *
31203
31756
  * @param request DescribeDisksRequest
31204
31757
  * @return DescribeDisksResponse
@@ -31269,9 +31822,10 @@ export default class Client extends OpenApi {
31269
31822
  describeElasticityAssurancesWithOptions(request: DescribeElasticityAssurancesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeElasticityAssurancesResponse>;
31270
31823
  describeElasticityAssurances(request: DescribeElasticityAssurancesRequest): Promise<DescribeElasticityAssurancesResponse>;
31271
31824
  /**
31272
- * The monitoring data includes traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of dropped packets sent and received by the secondary ENI. Specific information may be missing from the returned monitoring data. This is because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is bound is in the Stopped state, or if the secondary ENI is not bound to an instance and is in the Available state, the monitoring data of the secondary ENI cannot be obtained. When you call this operation, take note of the following items:
31273
- * * Up to 400 monitoring data entries can be returned at a time. If the value that is calculated by using the following formula is greater than 400: (EndTime - StartTime)/Period, an error is returned.
31274
- * * Only the monitoring data within the last 30 days can be queried. If the value of StartTime is more than 30 days earlier than the time when you call this operation, an error is returned.
31825
+ * ## [](#)Usage notes
31826
+ * The monitoring data of a secondary ENI includes the amount of traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of sent and received packets that are dropped by the secondary ENI. Specific information may be missing from the returned monitoring data. This may be because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is attached is in the Stopped state or if the secondary ENI is not attached to an instance and is in the Available state, the monitoring data of the secondary ENI cannot be obtained. Take note of the following items:
31827
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
31828
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
31275
31829
  *
31276
31830
  * @param request DescribeEniMonitorDataRequest
31277
31831
  * @param runtime runtime options for this request RuntimeOptions
@@ -31279,9 +31833,10 @@ export default class Client extends OpenApi {
31279
31833
  */
31280
31834
  describeEniMonitorDataWithOptions(request: DescribeEniMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeEniMonitorDataResponse>;
31281
31835
  /**
31282
- * The monitoring data includes traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of dropped packets sent and received by the secondary ENI. Specific information may be missing from the returned monitoring data. This is because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is bound is in the Stopped state, or if the secondary ENI is not bound to an instance and is in the Available state, the monitoring data of the secondary ENI cannot be obtained. When you call this operation, take note of the following items:
31283
- * * Up to 400 monitoring data entries can be returned at a time. If the value that is calculated by using the following formula is greater than 400: (EndTime - StartTime)/Period, an error is returned.
31284
- * * Only the monitoring data within the last 30 days can be queried. If the value of StartTime is more than 30 days earlier than the time when you call this operation, an error is returned.
31836
+ * ## [](#)Usage notes
31837
+ * The monitoring data of a secondary ENI includes the amount of traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of sent and received packets that are dropped by the secondary ENI. Specific information may be missing from the returned monitoring data. This may be because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is attached is in the Stopped state or if the secondary ENI is not attached to an instance and is in the Available state, the monitoring data of the secondary ENI cannot be obtained. Take note of the following items:
31838
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
31839
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
31285
31840
  *
31286
31841
  * @param request DescribeEniMonitorDataRequest
31287
31842
  * @return DescribeEniMonitorDataResponse
@@ -31394,9 +31949,11 @@ export default class Client extends OpenApi {
31394
31949
  describeImageSupportInstanceTypesWithOptions(request: DescribeImageSupportInstanceTypesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImageSupportInstanceTypesResponse>;
31395
31950
  describeImageSupportInstanceTypes(request: DescribeImageSupportInstanceTypesRequest): Promise<DescribeImageSupportInstanceTypesResponse>;
31396
31951
  /**
31952
+ * ## [](#)Usage notes
31397
31953
  * * You can query your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images from other Alibaba Cloud accounts.
31398
- * * This operation supports paged query. The response contains the total number of available images as well as the number of images on the returned page. By default, 10 entries are displayed on each page.
31399
- * * When you call an API operation by using Alibaba Cloud CLI, you must specify the request parameter values in their required formats. For more information, see [Parameter format overview](~~110340~~).
31954
+ * * This is a paginated query. The response contains the total number of available images and the images on the returned page. By default,10 entries are displayed on each page.
31955
+ * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter formats](~~110340~~).
31956
+ * * If you set ImageOwnerAlias to system or others when you call the DescribeImages operation to query public images that are provided by Alibaba Cloud or shared images, Resource Access Management (RAM) policies are ignored in the request. For more information, see [RAM authorization](~~25497~~).
31400
31957
  *
31401
31958
  * @param request DescribeImagesRequest
31402
31959
  * @param runtime runtime options for this request RuntimeOptions
@@ -31404,9 +31961,11 @@ export default class Client extends OpenApi {
31404
31961
  */
31405
31962
  describeImagesWithOptions(request: DescribeImagesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImagesResponse>;
31406
31963
  /**
31964
+ * ## [](#)Usage notes
31407
31965
  * * You can query your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images from other Alibaba Cloud accounts.
31408
- * * This operation supports paged query. The response contains the total number of available images as well as the number of images on the returned page. By default, 10 entries are displayed on each page.
31409
- * * When you call an API operation by using Alibaba Cloud CLI, you must specify the request parameter values in their required formats. For more information, see [Parameter format overview](~~110340~~).
31966
+ * * This is a paginated query. The response contains the total number of available images and the images on the returned page. By default,10 entries are displayed on each page.
31967
+ * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter formats](~~110340~~).
31968
+ * * If you set ImageOwnerAlias to system or others when you call the DescribeImages operation to query public images that are provided by Alibaba Cloud or shared images, Resource Access Management (RAM) policies are ignored in the request. For more information, see [RAM authorization](~~25497~~).
31410
31969
  *
31411
31970
  * @param request DescribeImagesRequest
31412
31971
  * @return DescribeImagesResponse
@@ -31504,10 +32063,12 @@ export default class Client extends OpenApi {
31504
32063
  */
31505
32064
  describeInstanceModificationPrice(request: DescribeInstanceModificationPriceRequest): Promise<DescribeInstanceModificationPriceResponse>;
31506
32065
  /**
32066
+ * ## [](#)Usage notes
31507
32067
  * Take note of the following items:
31508
- * * Up to 400 monitoring data entries can be returned at a time. An error is returned if the value that is calculated by using the following formula is greater than 400: `(EndTime - StartTime)/Period`.
31509
- * * You can query the monitoring data of the last 30 days. If the value of the `StartTime` parameter is more than 30 days earlier than the current time, an error is returned.
31510
- * * In some scenarios, such as when the instance is in the Stopped state, the system cannot obtain the relevant information and a portion may be missing from the returned monitoring data.
32068
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
32069
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
32070
+ * * In some scenarios, such as when the instance is in the Stopped state, the system cannot obtain the relevant information and specific information may be missing from the returned monitoring data.
32071
+ * * You cannot call this operation to obtain the CPU basic monitoring information of an ECS bare metal instance. To obtain the CPU monitoring information of an ECS bare metal instance, install the CloudMonitor agent on the instance. For more information, see [InstallCloudMonitor](~~183482~~).
31511
32072
  *
31512
32073
  * @param request DescribeInstanceMonitorDataRequest
31513
32074
  * @param runtime runtime options for this request RuntimeOptions
@@ -31515,10 +32076,12 @@ export default class Client extends OpenApi {
31515
32076
  */
31516
32077
  describeInstanceMonitorDataWithOptions(request: DescribeInstanceMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceMonitorDataResponse>;
31517
32078
  /**
32079
+ * ## [](#)Usage notes
31518
32080
  * Take note of the following items:
31519
- * * Up to 400 monitoring data entries can be returned at a time. An error is returned if the value that is calculated by using the following formula is greater than 400: `(EndTime - StartTime)/Period`.
31520
- * * You can query the monitoring data of the last 30 days. If the value of the `StartTime` parameter is more than 30 days earlier than the current time, an error is returned.
31521
- * * In some scenarios, such as when the instance is in the Stopped state, the system cannot obtain the relevant information and a portion may be missing from the returned monitoring data.
32081
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
32082
+ * * You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
32083
+ * * In some scenarios, such as when the instance is in the Stopped state, the system cannot obtain the relevant information and specific information may be missing from the returned monitoring data.
32084
+ * * You cannot call this operation to obtain the CPU basic monitoring information of an ECS bare metal instance. To obtain the CPU monitoring information of an ECS bare metal instance, install the CloudMonitor agent on the instance. For more information, see [InstallCloudMonitor](~~183482~~).
31522
32085
  *
31523
32086
  * @param request DescribeInstanceMonitorDataRequest
31524
32087
  * @return DescribeInstanceMonitorDataResponse
@@ -31601,26 +32164,17 @@ export default class Client extends OpenApi {
31601
32164
  */
31602
32165
  describeInstanceTypes(request: DescribeInstanceTypesRequest): Promise<DescribeInstanceTypesResponse>;
31603
32166
  /**
31604
- * ## Description
31605
- * When you call this operation, take note of the following items:
31606
- * * The URL returned is valid only for 15 seconds. If a connection is not established within 15 seconds after a successful query, the URL expires and you must query it again.
31607
- * * The **KeepAlive** time of a connection to a VNC management terminal is 60 seconds. If you do not interact with the VNC management terminal for 60 seconds, the VNC management terminal is automatically disconnected.
31608
- * * When you disconnect from the VNC management terminal, you can reconnect to the VNC management terminal up to 30 times a minute.
31609
- * * You must append the following parameters to the end of the `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?` URL: `vncUrl`, `instanceId`, `isWindows` (True or False), and `password`. Connect these parameters with ampersands (`&`).
31610
- * * `vncUrl:` the `VncUrl` value returned after a successful query.
31611
- * * `instanceId:` the ID of your instance.
31612
- * * `isWindows:` specifies whether the operating system of the instance is Windows. Set the parameter to `true` if the operating system is Windows. Set the parameter to `false` if the operating system is not Windows.
31613
- * * `password:` Optional. A six-character password used to connect to the VNC management terminal. It can contain digits and letters. You do not need to enter your password again when the connection is being established if you set this parameter.
31614
- * Example:
31615
- * ```
31616
- * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true
31617
- *
31618
- * ```
31619
- * Or:
31620
- * ```
31621
- * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true&password=****
31622
- *
31623
- * ```
32167
+ * ## [](#)Usage notes
32168
+ * Take note of the following items:
32169
+ * * The **keepalive** time of a connection to a VNC management terminal is 300 seconds. If you do not interact with the VNC management terminal for 300 seconds, the VNC management terminal is automatically disconnected.
32170
+ * * If the connection is interrupted, you must recall this operation to obtain a new logon address that is specified by `VncUrl` and use the new logon address to construct a URL that can be used to reconnect to the VNC management terminal. You can reconnect to a VNC management terminal for a maximum of 30 times per minute.
32171
+ * * You need to add the `vncUrl=\\*\\*\\*\\*`, `instanceId=\\*\\*\\*\\*`, and `isWindows=true/false` parameters to the end of the link `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?` and use an ampersand (`&`) between the parameters.
32172
+ * * `vncUrl`: the value of `VncUrl` that is returned after a successful call of this operation.
32173
+ * * `instanceId`: the ID of your instance.
32174
+ * * `isWindows`: specifies whether the operating system of your instance is Windows. A value of `true` indicates that the operating system is Windows. A value of `false` indicates that the operating system is not Windows.
32175
+ * > You can connect to an instance without a VNC logon password. Therefore, you do not need to configure the `password` parameter.
32176
+ * Sample URL:
32177
+ * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true
31624
32178
  *
31625
32179
  * @param request DescribeInstanceVncUrlRequest
31626
32180
  * @param runtime runtime options for this request RuntimeOptions
@@ -31628,26 +32182,17 @@ export default class Client extends OpenApi {
31628
32182
  */
31629
32183
  describeInstanceVncUrlWithOptions(request: DescribeInstanceVncUrlRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceVncUrlResponse>;
31630
32184
  /**
31631
- * ## Description
31632
- * When you call this operation, take note of the following items:
31633
- * * The URL returned is valid only for 15 seconds. If a connection is not established within 15 seconds after a successful query, the URL expires and you must query it again.
31634
- * * The **KeepAlive** time of a connection to a VNC management terminal is 60 seconds. If you do not interact with the VNC management terminal for 60 seconds, the VNC management terminal is automatically disconnected.
31635
- * * When you disconnect from the VNC management terminal, you can reconnect to the VNC management terminal up to 30 times a minute.
31636
- * * You must append the following parameters to the end of the `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?` URL: `vncUrl`, `instanceId`, `isWindows` (True or False), and `password`. Connect these parameters with ampersands (`&`).
31637
- * * `vncUrl:` the `VncUrl` value returned after a successful query.
31638
- * * `instanceId:` the ID of your instance.
31639
- * * `isWindows:` specifies whether the operating system of the instance is Windows. Set the parameter to `true` if the operating system is Windows. Set the parameter to `false` if the operating system is not Windows.
31640
- * * `password:` Optional. A six-character password used to connect to the VNC management terminal. It can contain digits and letters. You do not need to enter your password again when the connection is being established if you set this parameter.
31641
- * Example:
31642
- * ```
31643
- * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true
31644
- *
31645
- * ```
31646
- * Or:
31647
- * ```
31648
- * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true&password=****
31649
- *
31650
- * ```
32185
+ * ## [](#)Usage notes
32186
+ * Take note of the following items:
32187
+ * * The **keepalive** time of a connection to a VNC management terminal is 300 seconds. If you do not interact with the VNC management terminal for 300 seconds, the VNC management terminal is automatically disconnected.
32188
+ * * If the connection is interrupted, you must recall this operation to obtain a new logon address that is specified by `VncUrl` and use the new logon address to construct a URL that can be used to reconnect to the VNC management terminal. You can reconnect to a VNC management terminal for a maximum of 30 times per minute.
32189
+ * * You need to add the `vncUrl=\\*\\*\\*\\*`, `instanceId=\\*\\*\\*\\*`, and `isWindows=true/false` parameters to the end of the link `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?` and use an ampersand (`&`) between the parameters.
32190
+ * * `vncUrl`: the value of `VncUrl` that is returned after a successful call of this operation.
32191
+ * * `instanceId`: the ID of your instance.
32192
+ * * `isWindows`: specifies whether the operating system of your instance is Windows. A value of `true` indicates that the operating system is Windows. A value of `false` indicates that the operating system is not Windows.
32193
+ * > You can connect to an instance without a VNC logon password. Therefore, you do not need to configure the `password` parameter.
32194
+ * Sample URL:
32195
+ * https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%****&instanceId=i-wz9hhwq5a6tm****&isWindows=true
31651
32196
  *
31652
32197
  * @param request DescribeInstanceVncUrlRequest
31653
32198
  * @return DescribeInstanceVncUrlResponse
@@ -31719,10 +32264,12 @@ export default class Client extends OpenApi {
31719
32264
  */
31720
32265
  describeInvocationResults(request: DescribeInvocationResultsRequest): Promise<DescribeInvocationResultsResponse>;
31721
32266
  /**
31722
- * - After you run a command, the command may not succeed or return the expected result. You can call this operation to query the execution result.
31723
- * - You can query information about command executions within the last four weeks. A maximum of 100,000 entries of execution information can be retained.
31724
- * - Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocations operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.
31725
- * - Method 2: Use PageSize to specify the number of entries to return on each page, and then use PageNumber to specify the number of the page to return. You can use only one of the preceding methods. If you specify MaxResults or NextToken, the PageSize and PageNumber request parameters do not take effect and the TotalCount response parameter is invalid.
32267
+ * ## [](#)Usage notes
32268
+ * * After you run a command, the command may not succeed or return the expected results. You can call this operation to query the execution results.
32269
+ * * You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
32270
+ * * You can use one of the following methods to check the responses:
32271
+ * * Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, use `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which you can use in the next request to retrieve a new page of results. When you call the DescribeInvocations operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32272
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page, and then use `PageNumber` to specify the number of the page to return. You can use only one of the preceding methods. If you specify `MaxResults` or `NextToken`, the `PageSize` and `PageNumber` request parameters do not take effect and the `TotalCount` response parameter is invalid.
31726
32273
  *
31727
32274
  * @param request DescribeInvocationsRequest
31728
32275
  * @param runtime runtime options for this request RuntimeOptions
@@ -31730,10 +32277,12 @@ export default class Client extends OpenApi {
31730
32277
  */
31731
32278
  describeInvocationsWithOptions(request: DescribeInvocationsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInvocationsResponse>;
31732
32279
  /**
31733
- * - After you run a command, the command may not succeed or return the expected result. You can call this operation to query the execution result.
31734
- * - You can query information about command executions within the last four weeks. A maximum of 100,000 entries of execution information can be retained.
31735
- * - Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocations operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.
31736
- * - Method 2: Use PageSize to specify the number of entries to return on each page, and then use PageNumber to specify the number of the page to return. You can use only one of the preceding methods. If you specify MaxResults or NextToken, the PageSize and PageNumber request parameters do not take effect and the TotalCount response parameter is invalid.
32280
+ * ## [](#)Usage notes
32281
+ * * After you run a command, the command may not succeed or return the expected results. You can call this operation to query the execution results.
32282
+ * * You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
32283
+ * * You can use one of the following methods to check the responses:
32284
+ * * Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, use `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which you can use in the next request to retrieve a new page of results. When you call the DescribeInvocations operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32285
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page, and then use `PageNumber` to specify the number of the page to return. You can use only one of the preceding methods. If you specify `MaxResults` or `NextToken`, the `PageSize` and `PageNumber` request parameters do not take effect and the `TotalCount` response parameter is invalid.
31737
32286
  *
31738
32287
  * @param request DescribeInvocationsRequest
31739
32288
  * @return DescribeInvocationsResponse
@@ -31829,7 +32378,9 @@ export default class Client extends OpenApi {
31829
32378
  describeNetworkInterfacePermissionsWithOptions(request: DescribeNetworkInterfacePermissionsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNetworkInterfacePermissionsResponse>;
31830
32379
  describeNetworkInterfacePermissions(request: DescribeNetworkInterfacePermissionsRequest): Promise<DescribeNetworkInterfacePermissionsResponse>;
31831
32380
  /**
31832
- * You can call the `DescribeNetworkInterfaces` operation for paged query by specifying the `MaxResults` or `NextToken` parameter. During a paged query, when you call the DescribeNetworkInterfaces operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeNetworkInterfaces operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32381
+ * ## [](#)Usage notes
32382
+ * The `DescribeNetworkInterfaces` operation supports paged queries. During a paged query, when you call the DescribeNetworkInterfaces operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeNetworkInterfaces operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32383
+ * > If you specify `MaxResults` or `NextToken`, the system uses the preceding paged query method to return results. Otherwise, the system returns results based on the combination of `PageNumber` and `PageSize`.
31833
32384
  *
31834
32385
  * @param request DescribeNetworkInterfacesRequest
31835
32386
  * @param runtime runtime options for this request RuntimeOptions
@@ -31837,7 +32388,9 @@ export default class Client extends OpenApi {
31837
32388
  */
31838
32389
  describeNetworkInterfacesWithOptions(request: DescribeNetworkInterfacesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNetworkInterfacesResponse>;
31839
32390
  /**
31840
- * You can call the `DescribeNetworkInterfaces` operation for paged query by specifying the `MaxResults` or `NextToken` parameter. During a paged query, when you call the DescribeNetworkInterfaces operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeNetworkInterfaces operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32391
+ * ## [](#)Usage notes
32392
+ * The `DescribeNetworkInterfaces` operation supports paged queries. During a paged query, when you call the DescribeNetworkInterfaces operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeNetworkInterfaces operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32393
+ * > If you specify `MaxResults` or `NextToken`, the system uses the preceding paged query method to return results. Otherwise, the system returns results based on the combination of `PageNumber` and `PageSize`.
31841
32394
  *
31842
32395
  * @param request DescribeNetworkInterfacesRequest
31843
32396
  * @return DescribeNetworkInterfacesResponse
@@ -32044,10 +32597,11 @@ export default class Client extends OpenApi {
32044
32597
  */
32045
32598
  describeSecurityGroupReferences(request: DescribeSecurityGroupReferencesRequest): Promise<DescribeSecurityGroupReferencesResponse>;
32046
32599
  /**
32600
+ * ## [](#)Usage notes
32047
32601
  * Take note of the following items:
32048
- * * The basic information about security groups includes their IDs and descriptions. The response returns security groups ordered in descending order based on their IDs.
32049
- * * We recommend that you use NextToken and MaxResults for a paged query. We recommend that you use MaxResults to specify the maximum number of entries to return in each request. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, set NextToken to the value that is returned for NextToken in the previous call and use MaxResults to specify the maximum number of entries to return in this call. If the return value of NextToken is empty, the current page of results is the last page and no more results are to be returned.
32050
- * * When you use Alibaba Cloud CLI to call an API operation, you must specify values for request parameters of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
32602
+ * * The basic information about security groups includes their IDs and descriptions. The response returns security groups in descending order of the IDs of the security groups.
32603
+ * * We recommend that you use `MaxResults` and `NextToken` for a paged query. We recommend that you use `MaxResults` to specify the maximum number of entries to return for each request. The return value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeSecurityGroups operation to retrieve a new page of results, set `NextToken` to the `NextToken` value that is returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call. If the return value of `NextToken` is empty, the current page of results is the last page and no more results are to be returned.
32604
+ * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
32051
32605
  *
32052
32606
  * @param request DescribeSecurityGroupsRequest
32053
32607
  * @param runtime runtime options for this request RuntimeOptions
@@ -32055,10 +32609,11 @@ export default class Client extends OpenApi {
32055
32609
  */
32056
32610
  describeSecurityGroupsWithOptions(request: DescribeSecurityGroupsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSecurityGroupsResponse>;
32057
32611
  /**
32612
+ * ## [](#)Usage notes
32058
32613
  * Take note of the following items:
32059
- * * The basic information about security groups includes their IDs and descriptions. The response returns security groups ordered in descending order based on their IDs.
32060
- * * We recommend that you use NextToken and MaxResults for a paged query. We recommend that you use MaxResults to specify the maximum number of entries to return in each request. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, set NextToken to the value that is returned for NextToken in the previous call and use MaxResults to specify the maximum number of entries to return in this call. If the return value of NextToken is empty, the current page of results is the last page and no more results are to be returned.
32061
- * * When you use Alibaba Cloud CLI to call an API operation, you must specify values for request parameters of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
32614
+ * * The basic information about security groups includes their IDs and descriptions. The response returns security groups in descending order of the IDs of the security groups.
32615
+ * * We recommend that you use `MaxResults` and `NextToken` for a paged query. We recommend that you use `MaxResults` to specify the maximum number of entries to return for each request. The return value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeSecurityGroups operation to retrieve a new page of results, set `NextToken` to the `NextToken` value that is returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call. If the return value of `NextToken` is empty, the current page of results is the last page and no more results are to be returned.
32616
+ * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
32062
32617
  *
32063
32618
  * @param request DescribeSecurityGroupsRequest
32064
32619
  * @return DescribeSecurityGroupsResponse
@@ -32107,9 +32662,10 @@ export default class Client extends OpenApi {
32107
32662
  */
32108
32663
  describeSnapshotGroups(request: DescribeSnapshotGroupsRequest): Promise<DescribeSnapshotGroupsResponse>;
32109
32664
  /**
32110
- * When you call this operation, take note of the following items:
32111
- * * You can configure multiple request parameters, such as `RegionId`, `DiskIds`, and `InstanceId`, to query snapshot chains. The parameters have logical AND relations.
32112
- * * Only the configured parameters are used as filter conditions. If `DiskIds` and `SnapshotLinkIds` are set to empty JSON arrays, the values are considered as valid filter conditions. In this case, an empty result is returned.
32665
+ * ## [](#)Usage notes
32666
+ * Take note of the following items:
32667
+ * * You can specify multiple request parameters, such as `RegionId`, `DiskIds`, and `InstanceId`, to query snapshot chains. Specified parameters have logical AND relations.
32668
+ * * Only the specified parameters are used as filter conditions. If the `DiskIds` and `SnapshotLinkIds` parameters are set to empty JSON arrays, the values are considered as valid filter conditions. In this case, an empty result is returned.
32113
32669
  *
32114
32670
  * @param request DescribeSnapshotLinksRequest
32115
32671
  * @param runtime runtime options for this request RuntimeOptions
@@ -32117,18 +32673,20 @@ export default class Client extends OpenApi {
32117
32673
  */
32118
32674
  describeSnapshotLinksWithOptions(request: DescribeSnapshotLinksRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotLinksResponse>;
32119
32675
  /**
32120
- * When you call this operation, take note of the following items:
32121
- * * You can configure multiple request parameters, such as `RegionId`, `DiskIds`, and `InstanceId`, to query snapshot chains. The parameters have logical AND relations.
32122
- * * Only the configured parameters are used as filter conditions. If `DiskIds` and `SnapshotLinkIds` are set to empty JSON arrays, the values are considered as valid filter conditions. In this case, an empty result is returned.
32676
+ * ## [](#)Usage notes
32677
+ * Take note of the following items:
32678
+ * * You can specify multiple request parameters, such as `RegionId`, `DiskIds`, and `InstanceId`, to query snapshot chains. Specified parameters have logical AND relations.
32679
+ * * Only the specified parameters are used as filter conditions. If the `DiskIds` and `SnapshotLinkIds` parameters are set to empty JSON arrays, the values are considered as valid filter conditions. In this case, an empty result is returned.
32123
32680
  *
32124
32681
  * @param request DescribeSnapshotLinksRequest
32125
32682
  * @return DescribeSnapshotLinksResponse
32126
32683
  */
32127
32684
  describeSnapshotLinks(request: DescribeSnapshotLinksRequest): Promise<DescribeSnapshotLinksResponse>;
32128
32685
  /**
32686
+ * ## [](#)Usage notes
32129
32687
  * Take note of the following items:
32130
- * * Up to 400 entries of monitoring data can be returned at a time. If the result of the `(EndTime - StartTime)/Period` formula is greater than 400, an error is returned.
32131
- * * Only the monitored data within the last 30 days can be queried. If the value of `StartTime` is more than 30 days earlier than the time when you call this operation, an error is returned.
32688
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
32689
+ * * You can query the monitoring data of snapshot sizes in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
32132
32690
  *
32133
32691
  * @param request DescribeSnapshotMonitorDataRequest
32134
32692
  * @param runtime runtime options for this request RuntimeOptions
@@ -32136,9 +32694,10 @@ export default class Client extends OpenApi {
32136
32694
  */
32137
32695
  describeSnapshotMonitorDataWithOptions(request: DescribeSnapshotMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotMonitorDataResponse>;
32138
32696
  /**
32697
+ * ## [](#)Usage notes
32139
32698
  * Take note of the following items:
32140
- * * Up to 400 entries of monitoring data can be returned at a time. If the result of the `(EndTime - StartTime)/Period` formula is greater than 400, an error is returned.
32141
- * * Only the monitored data within the last 30 days can be queried. If the value of `StartTime` is more than 30 days earlier than the time when you call this operation, an error is returned.
32699
+ * * Up to 400 monitoring data entries can be returned at a time. Make sure that the `TotalCount` value does not exceed 400. The value is calculated by using the following formula: `TotalCount = (EndTime - StartTime)/Period`. If the TotalCount value is greater than 400, the `InvalidParameter.TooManyDataQueried` error is returned.
32700
+ * * You can query the monitoring data of snapshot sizes in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
32142
32701
  *
32143
32702
  * @param request DescribeSnapshotMonitorDataRequest
32144
32703
  * @return DescribeSnapshotMonitorDataResponse
@@ -32164,7 +32723,8 @@ export default class Client extends OpenApi {
32164
32723
  */
32165
32724
  describeSnapshots(request: DescribeSnapshotsRequest): Promise<DescribeSnapshotsResponse>;
32166
32725
  /**
32167
- * If you want to view the snapshot usage information about each disk in the current region, we recommend that you call the [DescribeSnapshotLinks](~~55837~~) operation to query snapshot chain information.
32726
+ * ## [](#)Usage notes
32727
+ * If you want to view the snapshot usage of each disk in the current region, we recommend that you call the [DescribeSnapshotLinks](~~55837~~) operation to query snapshot chain information.
32168
32728
  *
32169
32729
  * @param request DescribeSnapshotsUsageRequest
32170
32730
  * @param runtime runtime options for this request RuntimeOptions
@@ -32172,7 +32732,8 @@ export default class Client extends OpenApi {
32172
32732
  */
32173
32733
  describeSnapshotsUsageWithOptions(request: DescribeSnapshotsUsageRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotsUsageResponse>;
32174
32734
  /**
32175
- * If you want to view the snapshot usage information about each disk in the current region, we recommend that you call the [DescribeSnapshotLinks](~~55837~~) operation to query snapshot chain information.
32735
+ * ## [](#)Usage notes
32736
+ * If you want to view the snapshot usage of each disk in the current region, we recommend that you call the [DescribeSnapshotLinks](~~55837~~) operation to query snapshot chain information.
32176
32737
  *
32177
32738
  * @param request DescribeSnapshotsUsageRequest
32178
32739
  * @return DescribeSnapshotsUsageResponse
@@ -32251,6 +32812,21 @@ export default class Client extends OpenApi {
32251
32812
  * @return DescribeTasksResponse
32252
32813
  */
32253
32814
  describeTasks(request: DescribeTasksRequest): Promise<DescribeTasksResponse>;
32815
+ /**
32816
+ * You can query the session records of Session Manager that were generated in the last four weeks.
32817
+ *
32818
+ * @param request DescribeTerminalSessionsRequest
32819
+ * @param runtime runtime options for this request RuntimeOptions
32820
+ * @return DescribeTerminalSessionsResponse
32821
+ */
32822
+ describeTerminalSessionsWithOptions(request: DescribeTerminalSessionsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeTerminalSessionsResponse>;
32823
+ /**
32824
+ * You can query the session records of Session Manager that were generated in the last four weeks.
32825
+ *
32826
+ * @param request DescribeTerminalSessionsRequest
32827
+ * @return DescribeTerminalSessionsResponse
32828
+ */
32829
+ describeTerminalSessions(request: DescribeTerminalSessionsRequest): Promise<DescribeTerminalSessionsResponse>;
32254
32830
  /**
32255
32831
  * @deprecated
32256
32832
  *
@@ -32424,7 +33000,15 @@ export default class Client extends OpenApi {
32424
33000
  */
32425
33001
  detachKeyPair(request: DetachKeyPairRequest): Promise<DetachKeyPairResponse>;
32426
33002
  /**
32427
- * The operation that you want to perform. Set the value to **DetachNetworkInterface**.
33003
+ * Take note of the following items:
33004
+ * * You cannot detach the primary ENI of an instance.
33005
+ * * Make sure that the ENI to be detached is in the Detaching (Unbinding) or InUse (Bound) state.
33006
+ * * Make sure that the instance from which you want to detach an ENI is in the Running (Running) or Stopped (Stopped) state.
33007
+ * * The DetachNetworkInterface operation is an asynchronous operation. After this operation is called to detach an ENI, you can check the status or events of the ENI to determine whether the ENI is detached. The following figure shows the transitions between the states of the ENI.![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20230223/uemr/DetachNetworkInterface.png)
33008
+ * * If the ENI is in the Detaching state, the ENI detachment request is sent and the ENI is being detached from the associated instance.
33009
+ * * If the ENI is in the Available state, the ENI is detached from the associated instance.
33010
+ * * If the ENI is stuck in the Detaching state, the ENI may fail to be detached from the associated instance due to specific reasons. For example, the ENI may fail to be detached because the operating system of the instance did not respond to the ENI detachment request. If this issue occurs, you can re-initiate the request to detach the ENI. If the issue persists, restart the instance.
33011
+ * For information about examples on how to call the DetachNetworkInterface operation, see [Detach an ENI from an ECS instance](~~471551~~).
32428
33012
  *
32429
33013
  * @param request DetachNetworkInterfaceRequest
32430
33014
  * @param runtime runtime options for this request RuntimeOptions
@@ -32432,7 +33016,15 @@ export default class Client extends OpenApi {
32432
33016
  */
32433
33017
  detachNetworkInterfaceWithOptions(request: DetachNetworkInterfaceRequest, runtime: $Util.RuntimeOptions): Promise<DetachNetworkInterfaceResponse>;
32434
33018
  /**
32435
- * The operation that you want to perform. Set the value to **DetachNetworkInterface**.
33019
+ * Take note of the following items:
33020
+ * * You cannot detach the primary ENI of an instance.
33021
+ * * Make sure that the ENI to be detached is in the Detaching (Unbinding) or InUse (Bound) state.
33022
+ * * Make sure that the instance from which you want to detach an ENI is in the Running (Running) or Stopped (Stopped) state.
33023
+ * * The DetachNetworkInterface operation is an asynchronous operation. After this operation is called to detach an ENI, you can check the status or events of the ENI to determine whether the ENI is detached. The following figure shows the transitions between the states of the ENI.![](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20230223/uemr/DetachNetworkInterface.png)
33024
+ * * If the ENI is in the Detaching state, the ENI detachment request is sent and the ENI is being detached from the associated instance.
33025
+ * * If the ENI is in the Available state, the ENI is detached from the associated instance.
33026
+ * * If the ENI is stuck in the Detaching state, the ENI may fail to be detached from the associated instance due to specific reasons. For example, the ENI may fail to be detached because the operating system of the instance did not respond to the ENI detachment request. If this issue occurs, you can re-initiate the request to detach the ENI. If the issue persists, restart the instance.
33027
+ * For information about examples on how to call the DetachNetworkInterface operation, see [Detach an ENI from an ECS instance](~~471551~~).
32436
33028
  *
32437
33029
  * @param request DetachNetworkInterfaceRequest
32438
33030
  * @return DetachNetworkInterfaceResponse
@@ -32516,51 +33108,48 @@ export default class Client extends OpenApi {
32516
33108
  */
32517
33109
  enablePhysicalConnection(request: EnablePhysicalConnectionRequest): Promise<EnablePhysicalConnectionResponse>;
32518
33110
  /**
32519
- * Before you export a custom image, complete the following operations:
32520
- * * Understand the prerequisites and precautions. For more information, see [Export images](~~58181~~).
32521
- * * The Image Format parameter is available only for the following regions: India (Mumbai), Japan (Tokyo), Australia (Sydney), Indonesia (Jakarta), Germany (Frankfurt), UAE (Dubai), US (Virginia), UK (London), Singapore, US (Silicon Valley), and Malaysia (Kuala Lumpur). By default, custom images are exported in the RAW format in regions where the Image Format parameter is unavailable.
33111
+ * ## [](#)Usage notes
33112
+ * Before you export images, take note of the following items:
33113
+ * * Make sure that you are familiar with the prerequisites and precautions. For more information, see [Export a custom image](~~58181~~).
33114
+ * * The `ImageFormat` parameter is available only for the following regions: India (Mumbai), Japan (Tokyo), Australia (Sydney), Indonesia (Jakarta), Germany (Frankfurt), UAE (Dubai), US (Virginia), UK (London), Singapore, Malaysia (Kuala Lumpur), and US (Silicon Valley). By default, custom images are exported in the RAW format in regions where ImageFormat is unsupported.
32522
33115
  * * Use Resource Access Management (RAM) to grant Elastic Compute Service (ECS) the permissions to write data to OSS. To complete the authorization, perform the following operations:
32523
- * 1. Create a role named `AliyunECSImageExportDefaultRole`, and attach the following policy to the role:
32524
- * ```json
32525
- * {
32526
- * "Statement": [
32527
- * {
32528
- * "Action": "sts:AssumeRole",
32529
- * "Effect": "Allow",
32530
- * "Principal": {
32531
- * "Service": [
32532
- * "ecs.aliyuncs.com"
32533
- * ]
33116
+ * * Create a role named `AliyunECSImageExportDefaultRole`, and attach the following policy to the role:
33117
+ * {
33118
+ * "Statement": [
33119
+ * {
33120
+ * "Action": "sts:AssumeRole",
33121
+ * "Effect": "Allow",
33122
+ * "Principal": {
33123
+ * "Service": [
33124
+ * "ecs.aliyuncs.com"
33125
+ * ]
33126
+ * }
33127
+ * }
33128
+ * ],
33129
+ * "Version": "1"
32534
33130
  * }
32535
- * }
32536
- * ],
32537
- * "Version": "1"
32538
- * }
32539
- * ```
32540
- * 2. Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
32541
- * ```json
32542
- * {
32543
- * "Version": "1",
32544
- * "Statement": [
32545
- * {
32546
- * "Action": [
32547
- * "oss:GetObject",
32548
- * "oss:PutObject",
32549
- * "oss:DeleteObject",
32550
- * "oss:GetBucketLocation",
32551
- * "oss:GetBucketInfo",
32552
- * "oss:AbortMultipartUpload",
32553
- * "oss:ListMultipartUploads",
32554
- * "oss:ListParts"
32555
- * ],
32556
- * "Resource": "*",
32557
- * "Effect": "Allow"
32558
- * }
32559
- * ]
32560
- * }
32561
- * ```
32562
- * After you export a custom image, the following situation occurs:
32563
- * The custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
33131
+ * * Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
33132
+ * {
33133
+ * "Version": "1",
33134
+ * "Statement": [
33135
+ * {
33136
+ * "Action": [
33137
+ * "oss:GetObject",
33138
+ * "oss:PutObject",
33139
+ * "oss:DeleteObject",
33140
+ * "oss:GetBucketLocation",
33141
+ * "oss:GetBucketInfo",
33142
+ * "oss:AbortMultipartUpload",
33143
+ * "oss:ListMultipartUploads",
33144
+ * "oss:ListParts"
33145
+ * ],
33146
+ * "Resource": "*",
33147
+ * "Effect": "Allow"
33148
+ * }
33149
+ * ]
33150
+ * }
33151
+ * After you export the images, take note of the following items:
33152
+ * Each exported custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
32564
33153
  *
32565
33154
  * @param request ExportImageRequest
32566
33155
  * @param runtime runtime options for this request RuntimeOptions
@@ -32568,51 +33157,48 @@ export default class Client extends OpenApi {
32568
33157
  */
32569
33158
  exportImageWithOptions(request: ExportImageRequest, runtime: $Util.RuntimeOptions): Promise<ExportImageResponse>;
32570
33159
  /**
32571
- * Before you export a custom image, complete the following operations:
32572
- * * Understand the prerequisites and precautions. For more information, see [Export images](~~58181~~).
32573
- * * The Image Format parameter is available only for the following regions: India (Mumbai), Japan (Tokyo), Australia (Sydney), Indonesia (Jakarta), Germany (Frankfurt), UAE (Dubai), US (Virginia), UK (London), Singapore, US (Silicon Valley), and Malaysia (Kuala Lumpur). By default, custom images are exported in the RAW format in regions where the Image Format parameter is unavailable.
33160
+ * ## [](#)Usage notes
33161
+ * Before you export images, take note of the following items:
33162
+ * * Make sure that you are familiar with the prerequisites and precautions. For more information, see [Export a custom image](~~58181~~).
33163
+ * * The `ImageFormat` parameter is available only for the following regions: India (Mumbai), Japan (Tokyo), Australia (Sydney), Indonesia (Jakarta), Germany (Frankfurt), UAE (Dubai), US (Virginia), UK (London), Singapore, Malaysia (Kuala Lumpur), and US (Silicon Valley). By default, custom images are exported in the RAW format in regions where ImageFormat is unsupported.
32574
33164
  * * Use Resource Access Management (RAM) to grant Elastic Compute Service (ECS) the permissions to write data to OSS. To complete the authorization, perform the following operations:
32575
- * 1. Create a role named `AliyunECSImageExportDefaultRole`, and attach the following policy to the role:
32576
- * ```json
32577
- * {
32578
- * "Statement": [
32579
- * {
32580
- * "Action": "sts:AssumeRole",
32581
- * "Effect": "Allow",
32582
- * "Principal": {
32583
- * "Service": [
32584
- * "ecs.aliyuncs.com"
32585
- * ]
33165
+ * * Create a role named `AliyunECSImageExportDefaultRole`, and attach the following policy to the role:
33166
+ * {
33167
+ * "Statement": [
33168
+ * {
33169
+ * "Action": "sts:AssumeRole",
33170
+ * "Effect": "Allow",
33171
+ * "Principal": {
33172
+ * "Service": [
33173
+ * "ecs.aliyuncs.com"
33174
+ * ]
33175
+ * }
33176
+ * }
33177
+ * ],
33178
+ * "Version": "1"
32586
33179
  * }
32587
- * }
32588
- * ],
32589
- * "Version": "1"
32590
- * }
32591
- * ```
32592
- * 2. Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
32593
- * ```json
32594
- * {
32595
- * "Version": "1",
32596
- * "Statement": [
32597
- * {
32598
- * "Action": [
32599
- * "oss:GetObject",
32600
- * "oss:PutObject",
32601
- * "oss:DeleteObject",
32602
- * "oss:GetBucketLocation",
32603
- * "oss:GetBucketInfo",
32604
- * "oss:AbortMultipartUpload",
32605
- * "oss:ListMultipartUploads",
32606
- * "oss:ListParts"
32607
- * ],
32608
- * "Resource": "*",
32609
- * "Effect": "Allow"
32610
- * }
32611
- * ]
32612
- * }
32613
- * ```
32614
- * After you export a custom image, the following situation occurs:
32615
- * The custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
33180
+ * * Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
33181
+ * {
33182
+ * "Version": "1",
33183
+ * "Statement": [
33184
+ * {
33185
+ * "Action": [
33186
+ * "oss:GetObject",
33187
+ * "oss:PutObject",
33188
+ * "oss:DeleteObject",
33189
+ * "oss:GetBucketLocation",
33190
+ * "oss:GetBucketInfo",
33191
+ * "oss:AbortMultipartUpload",
33192
+ * "oss:ListMultipartUploads",
33193
+ * "oss:ListParts"
33194
+ * ],
33195
+ * "Resource": "*",
33196
+ * "Effect": "Allow"
33197
+ * }
33198
+ * ]
33199
+ * }
33200
+ * After you export the images, take note of the following items:
33201
+ * Each exported custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
32616
33202
  *
32617
33203
  * @param request ExportImageRequest
32618
33204
  * @return ExportImageResponse
@@ -32633,7 +33219,24 @@ export default class Client extends OpenApi {
32633
33219
  * @return ExportSnapshotResponse
32634
33220
  */
32635
33221
  exportSnapshot(request: ExportSnapshotRequest): Promise<ExportSnapshotResponse>;
33222
+ /**
33223
+ * * ECS is a virtualized cloud-based service and cannot be connected to display devices. Alibaba Cloud caches system command outputs for the last start, restart, or shutdown of ECS instances. You can call the GetInstanceConsoleOutput operation to query the command outputs.
33224
+ * * For instances of the retired instance types, you cannot obtain command outputs. For more information, see [Retired instance types](~~55263~~).
33225
+ * * You cannot obtain the command outputs of Windows instances.
33226
+ *
33227
+ * @param request GetInstanceConsoleOutputRequest
33228
+ * @param runtime runtime options for this request RuntimeOptions
33229
+ * @return GetInstanceConsoleOutputResponse
33230
+ */
32636
33231
  getInstanceConsoleOutputWithOptions(request: GetInstanceConsoleOutputRequest, runtime: $Util.RuntimeOptions): Promise<GetInstanceConsoleOutputResponse>;
33232
+ /**
33233
+ * * ECS is a virtualized cloud-based service and cannot be connected to display devices. Alibaba Cloud caches system command outputs for the last start, restart, or shutdown of ECS instances. You can call the GetInstanceConsoleOutput operation to query the command outputs.
33234
+ * * For instances of the retired instance types, you cannot obtain command outputs. For more information, see [Retired instance types](~~55263~~).
33235
+ * * You cannot obtain the command outputs of Windows instances.
33236
+ *
33237
+ * @param request GetInstanceConsoleOutputRequest
33238
+ * @return GetInstanceConsoleOutputResponse
33239
+ */
32637
33240
  getInstanceConsoleOutput(request: GetInstanceConsoleOutputRequest): Promise<GetInstanceConsoleOutputResponse>;
32638
33241
  /**
32639
33242
  * After ECS returns a Base64-encoded instance screenshot in the JPG format, you must decode the screenshot. We recommend that you call this operation for troubleshooting and diagnosis. When you call this operation, take note of the following items:
@@ -32657,11 +33260,12 @@ export default class Client extends OpenApi {
32657
33260
  */
32658
33261
  getInstanceScreenshot(request: GetInstanceScreenshotRequest): Promise<GetInstanceScreenshotResponse>;
32659
33262
  /**
32660
- * When you call this operation, take note of the following items:
32661
- * * Before you can import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
32662
- * * In some scenarios, you may want to create an image based on the operating system data of a source server, import the image to ECS, and then create an ECS instance from the imported image. The source server can be a physical server, a virtual machine, or a cloud host. If the virtio driver is not installed on the source server, the created ECS instance may be unable to start. To prevent this issue, make sure that the virtio driver is installed on the source server before you import an image to Alibaba Cloud. For more information, see [Install the virtio driver](~~62423~~).
32663
- * * Before you import images for the first time, you must use Resource Access Management (RAM) to authorize ECS to access your OSS buckets. If ECS is not authorized to access your OSS buckets, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. The [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page in the RAM console provides a convenient push-button authorization feature for this operation. You can also perform the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
32664
- * 1. Create a role named `AliyunECSImageImportDefaultRole`. You must use this exact name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
33263
+ * ### [](#)Usage notes
33264
+ * Take note of the following items:
33265
+ * * Before you import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
33266
+ * * In some scenarios, you may want to create a custom image based on the operating system data of a source server, import the image to Alibaba Cloud, and then create an ECS instance from the image. The source server can be a physical server, a virtual machine, or a cloud host. If the virtio driver is not installed on the source server, the created ECS instance may be unable to start. To prevent this issue, verify that the virtio driver is installed on the source server before you import the image to Alibaba Cloud. For more information, see [Install the virtio driver](~~62423~~).
33267
+ * * Before you import images for the first time, you must use Resource Access Management (RAM) to authorize ECS to access your OSS buckets. If ECS is not authorized to access your OSS buckets, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. You can complete the authorization with one click on the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page of the RAM console. You can also complete the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
33268
+ * 1. Create a RAM role named `AliyunECSImageImportDefaultRole`. You must use this exact role name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
32665
33269
  * {
32666
33270
  * "Statement": [
32667
33271
  * {
@@ -32676,7 +33280,7 @@ export default class Client extends OpenApi {
32676
33280
  * ],
32677
33281
  * "Version": "1"
32678
33282
  * }
32679
- * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the role. You can also create a custom policy that contains the following content and attach the policy to the role:
33283
+ * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the RAM role. You can also create a custom policy that contains the following content and attach the policy to the role:
32680
33284
  * ```
32681
33285
  * {
32682
33286
  * "Version": "1",
@@ -32694,19 +33298,20 @@ export default class Client extends OpenApi {
32694
33298
  * }
32695
33299
  * ```
32696
33300
  * * You cannot delete an image that is being imported. However, you can call the [CancelTask](~~25624~~) operation to cancel the image import task.
32697
- * * You can import an image only to the same region as the OSS bucket to which the image was uploaded.
32698
- * * The valid values of N in the `DiskDeviceMapping.N` parameter range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk.
33301
+ * * You can import an image only to the same region as the OSS bucket to which the image file is uploaded.
33302
+ * * The valid values of N in `DiskDeviceMapping.N` range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk. When N is set to a value greater than 17, parameters prefixed with DiskDeviceMapping.N are ignored.
32699
33303
  * * When you set `Architecture` to `arm64` or when you set `Platform` to `CentOS Stream`, `Anolis`, `AlmaLinux`, `UOS`, `Kylin`, or `Rocky Linux`, take note of the following items:
32700
- * * To ensure that the password can be set, or that the key pair can be modified for an imported image, the image must meet the following requirements:
32701
- * * The operating system kernel supports the `CONFIG_FW_CFG_SYSFS` feature. By default, Linux community kernel 4.6 and later, as well as CentOS kernel 3.10.0-826.el7 and later, support this feature. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command in the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the kernel of this image supports the `CONFIG_FW_CFG_SYSFS` feature.
32702
- * * The latest version of Alibaba Cloud cloud-init is installed on the operating system. If the installed version of cloud-init is 19.1, make sure that the minor version is 19.1.3 or later. If the installed version of cloud-init is 0.7.6a as in some early versions of operating systems, make sure that the minor version is 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
33304
+ * * To ensure that the password can be set or the key pair can be modified for an imported image, make sure that the image meets the following requirements before you import it:
33305
+ * * The kernel of the operating system supports the `CONFIG_FW_CFG_SYSFS` feature. By default, Linux community kernel 4.6 and later and CentOS kernel 3.10.0-826.el7 and later support the CONFIG_FW_CFG_SYSFS feature. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command on the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the kernel of the image supports the `CONFIG_FW_CFG_SYSFS` feature.
33306
+ * * Alibaba Cloud cloud-init of the latest version is installed on the operating system. If the version of cloud-init is 19.1, the minor version must be 19.1.3 or later. If the version of cloud-init is 0.7.6a in some early versions of operating systems, the minor version must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
32703
33307
  * * The operating system supports the SHA-512 encryption algorithm.
32704
33308
  * * If you want an imported image to support the resizing of disks and file systems, make sure that the image meets the following requirements before you import it:
32705
33309
  * * The kernel version of the operating system is later than 3.6.
32706
- * * The image supports the growpart command. To support this command, you must install the `cloud-utils-growpart` package. Package installation methods vary based on operating systems. For more information, see [Resize partitions and file systems of Linux system disks](~~111738~~).
32707
- * * The image supports the resize2fs command. To support this command, you must install the `e2fsprogs` package. By default, the package is installed on the operating system. If the package is not installed, you must install it.
32708
- * * The latest version of Alibaba Cloud cloud-init is installed on the operating system. If the installed version of cloud-init is 19.1, make sure that the minor version is 19.1.3 or later. If the installed version of cloud-init is 0.7.6a as in some early versions of operating systems, make sure that the minor version is 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
32709
- * * If the image that you want to import uses the ARM64 architecture, you must configure the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](~~405080~~).
33310
+ * * The image supports the growpart command. To support this command, you must install the `cloud-utils-growpart` package. The methods of installing the package vary based on operating systems. For more information, see [Extend the partitions and file systems of disks on a Linux instance](~~25451~~).
33311
+ * * The image supports the resize2fs command. To support this command, you must install the `e2fsprogs` package. By default, the package is installed on the operating system. If the package is not installed, install it.
33312
+ * * Alibaba Cloud cloud-init of the latest version is installed on the operating system. If the version of cloud-init is 19.1, the minor version must be 19.1.3 or later. If the version of cloud-init is 0.7.6a in some early versions of operating systems, the minor version must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
33313
+ * * If the image that you want to import uses the Arm64 architecture, configure the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](~~405080~~).
33314
+ * * When you import images, we recommend that you specify DetectionStrategy. This way, you can optimize the images based on the image check results. For more information, see [Overview](~~439819~~).
32710
33315
  *
32711
33316
  * @param request ImportImageRequest
32712
33317
  * @param runtime runtime options for this request RuntimeOptions
@@ -32714,11 +33319,12 @@ export default class Client extends OpenApi {
32714
33319
  */
32715
33320
  importImageWithOptions(request: ImportImageRequest, runtime: $Util.RuntimeOptions): Promise<ImportImageResponse>;
32716
33321
  /**
32717
- * When you call this operation, take note of the following items:
32718
- * * Before you can import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
32719
- * * In some scenarios, you may want to create an image based on the operating system data of a source server, import the image to ECS, and then create an ECS instance from the imported image. The source server can be a physical server, a virtual machine, or a cloud host. If the virtio driver is not installed on the source server, the created ECS instance may be unable to start. To prevent this issue, make sure that the virtio driver is installed on the source server before you import an image to Alibaba Cloud. For more information, see [Install the virtio driver](~~62423~~).
32720
- * * Before you import images for the first time, you must use Resource Access Management (RAM) to authorize ECS to access your OSS buckets. If ECS is not authorized to access your OSS buckets, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. The [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page in the RAM console provides a convenient push-button authorization feature for this operation. You can also perform the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
32721
- * 1. Create a role named `AliyunECSImageImportDefaultRole`. You must use this exact name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
33322
+ * ### [](#)Usage notes
33323
+ * Take note of the following items:
33324
+ * * Before you import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
33325
+ * * In some scenarios, you may want to create a custom image based on the operating system data of a source server, import the image to Alibaba Cloud, and then create an ECS instance from the image. The source server can be a physical server, a virtual machine, or a cloud host. If the virtio driver is not installed on the source server, the created ECS instance may be unable to start. To prevent this issue, verify that the virtio driver is installed on the source server before you import the image to Alibaba Cloud. For more information, see [Install the virtio driver](~~62423~~).
33326
+ * * Before you import images for the first time, you must use Resource Access Management (RAM) to authorize ECS to access your OSS buckets. If ECS is not authorized to access your OSS buckets, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. You can complete the authorization with one click on the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page of the RAM console. You can also complete the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
33327
+ * 1. Create a RAM role named `AliyunECSImageImportDefaultRole`. You must use this exact role name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
32722
33328
  * {
32723
33329
  * "Statement": [
32724
33330
  * {
@@ -32733,7 +33339,7 @@ export default class Client extends OpenApi {
32733
33339
  * ],
32734
33340
  * "Version": "1"
32735
33341
  * }
32736
- * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the role. You can also create a custom policy that contains the following content and attach the policy to the role:
33342
+ * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the RAM role. You can also create a custom policy that contains the following content and attach the policy to the role:
32737
33343
  * ```
32738
33344
  * {
32739
33345
  * "Version": "1",
@@ -32751,19 +33357,20 @@ export default class Client extends OpenApi {
32751
33357
  * }
32752
33358
  * ```
32753
33359
  * * You cannot delete an image that is being imported. However, you can call the [CancelTask](~~25624~~) operation to cancel the image import task.
32754
- * * You can import an image only to the same region as the OSS bucket to which the image was uploaded.
32755
- * * The valid values of N in the `DiskDeviceMapping.N` parameter range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk.
33360
+ * * You can import an image only to the same region as the OSS bucket to which the image file is uploaded.
33361
+ * * The valid values of N in `DiskDeviceMapping.N` range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk. When N is set to a value greater than 17, parameters prefixed with DiskDeviceMapping.N are ignored.
32756
33362
  * * When you set `Architecture` to `arm64` or when you set `Platform` to `CentOS Stream`, `Anolis`, `AlmaLinux`, `UOS`, `Kylin`, or `Rocky Linux`, take note of the following items:
32757
- * * To ensure that the password can be set, or that the key pair can be modified for an imported image, the image must meet the following requirements:
32758
- * * The operating system kernel supports the `CONFIG_FW_CFG_SYSFS` feature. By default, Linux community kernel 4.6 and later, as well as CentOS kernel 3.10.0-826.el7 and later, support this feature. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command in the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the kernel of this image supports the `CONFIG_FW_CFG_SYSFS` feature.
32759
- * * The latest version of Alibaba Cloud cloud-init is installed on the operating system. If the installed version of cloud-init is 19.1, make sure that the minor version is 19.1.3 or later. If the installed version of cloud-init is 0.7.6a as in some early versions of operating systems, make sure that the minor version is 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
33363
+ * * To ensure that the password can be set or the key pair can be modified for an imported image, make sure that the image meets the following requirements before you import it:
33364
+ * * The kernel of the operating system supports the `CONFIG_FW_CFG_SYSFS` feature. By default, Linux community kernel 4.6 and later and CentOS kernel 3.10.0-826.el7 and later support the CONFIG_FW_CFG_SYSFS feature. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command on the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the kernel of the image supports the `CONFIG_FW_CFG_SYSFS` feature.
33365
+ * * Alibaba Cloud cloud-init of the latest version is installed on the operating system. If the version of cloud-init is 19.1, the minor version must be 19.1.3 or later. If the version of cloud-init is 0.7.6a in some early versions of operating systems, the minor version must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
32760
33366
  * * The operating system supports the SHA-512 encryption algorithm.
32761
33367
  * * If you want an imported image to support the resizing of disks and file systems, make sure that the image meets the following requirements before you import it:
32762
33368
  * * The kernel version of the operating system is later than 3.6.
32763
- * * The image supports the growpart command. To support this command, you must install the `cloud-utils-growpart` package. Package installation methods vary based on operating systems. For more information, see [Resize partitions and file systems of Linux system disks](~~111738~~).
32764
- * * The image supports the resize2fs command. To support this command, you must install the `e2fsprogs` package. By default, the package is installed on the operating system. If the package is not installed, you must install it.
32765
- * * The latest version of Alibaba Cloud cloud-init is installed on the operating system. If the installed version of cloud-init is 19.1, make sure that the minor version is 19.1.3 or later. If the installed version of cloud-init is 0.7.6a as in some early versions of operating systems, make sure that the minor version is 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
32766
- * * If the image that you want to import uses the ARM64 architecture, you must configure the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](~~405080~~).
33369
+ * * The image supports the growpart command. To support this command, you must install the `cloud-utils-growpart` package. The methods of installing the package vary based on operating systems. For more information, see [Extend the partitions and file systems of disks on a Linux instance](~~25451~~).
33370
+ * * The image supports the resize2fs command. To support this command, you must install the `e2fsprogs` package. By default, the package is installed on the operating system. If the package is not installed, install it.
33371
+ * * Alibaba Cloud cloud-init of the latest version is installed on the operating system. If the version of cloud-init is 19.1, the minor version must be 19.1.3 or later. If the version of cloud-init is 0.7.6a in some early versions of operating systems, the minor version must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
33372
+ * * If the image that you want to import uses the Arm64 architecture, configure the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](~~405080~~).
33373
+ * * When you import images, we recommend that you specify DetectionStrategy. This way, you can optimize the images based on the image check results. For more information, see [Overview](~~439819~~).
32767
33374
  *
32768
33375
  * @param request ImportImageRequest
32769
33376
  * @return ImportImageResponse
@@ -32828,21 +33435,21 @@ export default class Client extends OpenApi {
32828
33435
  */
32829
33436
  installCloudAssistant(request: InstallCloudAssistantRequest): Promise<InstallCloudAssistantResponse>;
32830
33437
  /**
32831
- * ## Usage notes
32832
- * * ECS instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
32833
- * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query instance states.
33438
+ * ## [](#)Usage notes
33439
+ * * The Elastic Compute Service (ECS) instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
33440
+ * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
32834
33441
  * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
32835
33442
  * * Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
32836
- * * The command can run only once on the instances.
32837
- * * The command can run multiple times on the instances based on a schedule.
32838
- * * The schedule is specified by the Frequency parameter. The results of each execution of a command do not affect the next execution of the command.
32839
- * * If you want to specify a schedule by using a cron expression, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32840
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Update or disable updates for Cloud Assistant Agent](~~134383~~).
33443
+ * * You can configure the command to run only once on the instances.
33444
+ * * You can configure the command to run multiple times on the instances based on a schedule.
33445
+ * * The schedule is specified by the Frequency parameter. The results of each execution of the command do not affect the next execution of the command.
33446
+ * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
33447
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
32841
33448
  * * Linux: 2.2.3.282
32842
33449
  * * Windows: 2.1.3.282
32843
33450
  * * Commands may fail to run due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command fails to run, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
32844
- * * If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
32845
- * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the state of Cloud Assistant Agent installed on the instances and make sure that the return value of CloudAssistantStatus is true.
33451
+ * * If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
33452
+ * * Before you run the command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances. Run the command when the return value of CloudAssistantStatus is true.
32846
33453
  *
32847
33454
  * @param tmpReq InvokeCommandRequest
32848
33455
  * @param runtime runtime options for this request RuntimeOptions
@@ -32850,21 +33457,21 @@ export default class Client extends OpenApi {
32850
33457
  */
32851
33458
  invokeCommandWithOptions(tmpReq: InvokeCommandRequest, runtime: $Util.RuntimeOptions): Promise<InvokeCommandResponse>;
32852
33459
  /**
32853
- * ## Usage notes
32854
- * * ECS instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
32855
- * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query instance states.
33460
+ * ## [](#)Usage notes
33461
+ * * The Elastic Compute Service (ECS) instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
33462
+ * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
32856
33463
  * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
32857
33464
  * * Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
32858
- * * The command can run only once on the instances.
32859
- * * The command can run multiple times on the instances based on a schedule.
32860
- * * The schedule is specified by the Frequency parameter. The results of each execution of a command do not affect the next execution of the command.
32861
- * * If you want to specify a schedule by using a cron expression, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32862
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Update or disable updates for Cloud Assistant Agent](~~134383~~).
33465
+ * * You can configure the command to run only once on the instances.
33466
+ * * You can configure the command to run multiple times on the instances based on a schedule.
33467
+ * * The schedule is specified by the Frequency parameter. The results of each execution of the command do not affect the next execution of the command.
33468
+ * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
33469
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
32863
33470
  * * Linux: 2.2.3.282
32864
33471
  * * Windows: 2.1.3.282
32865
33472
  * * Commands may fail to run due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command fails to run, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
32866
- * * If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
32867
- * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the state of Cloud Assistant Agent installed on the instances and make sure that the return value of CloudAssistantStatus is true.
33473
+ * * If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
33474
+ * * Before you run the command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances. Run the command when the return value of CloudAssistantStatus is true.
32868
33475
  *
32869
33476
  * @param request InvokeCommandRequest
32870
33477
  * @return InvokeCommandResponse
@@ -32886,16 +33493,16 @@ export default class Client extends OpenApi {
32886
33493
  */
32887
33494
  joinResourceGroup(request: JoinResourceGroupRequest): Promise<JoinResourceGroupResponse>;
32888
33495
  /**
32889
- * ## Usage notes
32890
- * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add an instance to or remove an instance from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add an ENI to or remove an ENI from a security group.
33496
+ * ## [](#)Usage notes
33497
+ * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add an instance to or remove an instance from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add an ENI to or remove an ENI from a security group.
32891
33498
  * Take note of the following items:
32892
- * * Before you add an instance to a security group, the instance must be in the **Stopped** or **Running** state.
32893
- * * An instance can be added to up to five security groups.
32894
- * * You can increase this number to 16 by [submitting a ticket](https://workorder-intl.console.aliyun.com/#/ticket/createIndex).
33499
+ * * Before you add an instance to a security group, the instance must be in the **Stopped** (Stopped) or **Running** (Running) state.
33500
+ * * An instance can be added to up to five security groups by default.
33501
+ * * To add an instance to more security groups, [submit a ticket](https://workorder-intl.console.aliyun.com/#/ticket/createIndex). An instance can be added to up to 16 security groups.
32895
33502
  * * A basic security group can contain up to 2,000 instances. An advanced security group can contain up to 65,536 instances.
32896
33503
  * * The security group and the instance must reside in the same region.
32897
- * * The security group and the instance must be of the same network type. If the network type is virtual private cloud (VPC), the security group and the instance must be in the same VPC.
32898
- * * An instance and an ENI cannot be added to a security group at the same time. You cannot configure the `InstanceId` and `NetworkInterfaceId` parameters at the same time.
33504
+ * * The security group and the instance must be of the same network type. If the network type is virtual private cloud (VPC), the security group and the instance must reside in the same VPC.
33505
+ * * An instance and an ENI cannot be added to a security group at the same time. You cannot specify `InstanceId` and `NetworkInterfaceId` at the same time in a request.
32899
33506
  *
32900
33507
  * @param request JoinSecurityGroupRequest
32901
33508
  * @param runtime runtime options for this request RuntimeOptions
@@ -32903,16 +33510,16 @@ export default class Client extends OpenApi {
32903
33510
  */
32904
33511
  joinSecurityGroupWithOptions(request: JoinSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<JoinSecurityGroupResponse>;
32905
33512
  /**
32906
- * ## Usage notes
32907
- * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add an instance to or remove an instance from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add an ENI to or remove an ENI from a security group.
33513
+ * ## [](#)Usage notes
33514
+ * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add an instance to or remove an instance from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add an ENI to or remove an ENI from a security group.
32908
33515
  * Take note of the following items:
32909
- * * Before you add an instance to a security group, the instance must be in the **Stopped** or **Running** state.
32910
- * * An instance can be added to up to five security groups.
32911
- * * You can increase this number to 16 by [submitting a ticket](https://workorder-intl.console.aliyun.com/#/ticket/createIndex).
33516
+ * * Before you add an instance to a security group, the instance must be in the **Stopped** (Stopped) or **Running** (Running) state.
33517
+ * * An instance can be added to up to five security groups by default.
33518
+ * * To add an instance to more security groups, [submit a ticket](https://workorder-intl.console.aliyun.com/#/ticket/createIndex). An instance can be added to up to 16 security groups.
32912
33519
  * * A basic security group can contain up to 2,000 instances. An advanced security group can contain up to 65,536 instances.
32913
33520
  * * The security group and the instance must reside in the same region.
32914
- * * The security group and the instance must be of the same network type. If the network type is virtual private cloud (VPC), the security group and the instance must be in the same VPC.
32915
- * * An instance and an ENI cannot be added to a security group at the same time. You cannot configure the `InstanceId` and `NetworkInterfaceId` parameters at the same time.
33521
+ * * The security group and the instance must be of the same network type. If the network type is virtual private cloud (VPC), the security group and the instance must reside in the same VPC.
33522
+ * * An instance and an ENI cannot be added to a security group at the same time. You cannot specify `InstanceId` and `NetworkInterfaceId` at the same time in a request.
32916
33523
  *
32917
33524
  * @param request JoinSecurityGroupRequest
32918
33525
  * @return JoinSecurityGroupResponse
@@ -33048,6 +33655,8 @@ export default class Client extends OpenApi {
33048
33655
  modifyBandwidthPackageSpec(request: ModifyBandwidthPackageSpecRequest): Promise<ModifyBandwidthPackageSpecResponse>;
33049
33656
  modifyCapacityReservationWithOptions(request: ModifyCapacityReservationRequest, runtime: $Util.RuntimeOptions): Promise<ModifyCapacityReservationResponse>;
33050
33657
  modifyCapacityReservation(request: ModifyCapacityReservationRequest): Promise<ModifyCapacityReservationResponse>;
33658
+ modifyCloudAssistantSettingsWithOptions(tmpReq: ModifyCloudAssistantSettingsRequest, runtime: $Util.RuntimeOptions): Promise<ModifyCloudAssistantSettingsResponse>;
33659
+ modifyCloudAssistantSettings(request: ModifyCloudAssistantSettingsRequest): Promise<ModifyCloudAssistantSettingsResponse>;
33051
33660
  /**
33052
33661
  * You can modify a command when it is run. After the command is modified, the new command content applies to subsequent executions.
33053
33662
  * You cannot modify the command type. For example, you cannot change a shell command (RunShellScript) to a batch command (RunBatScript).
@@ -33191,7 +33800,44 @@ export default class Client extends OpenApi {
33191
33800
  * @return ModifyDiskChargeTypeResponse
33192
33801
  */
33193
33802
  modifyDiskChargeType(request: ModifyDiskChargeTypeRequest): Promise<ModifyDiskChargeTypeResponse>;
33803
+ /**
33804
+ * ### [](#)Usage notes
33805
+ * > The Dedicated Block Storage Cluster feature is available in the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Heyuan), Indonesia (Jakarta), Germany (Frankfurt), and China South 1 Finance.
33806
+ * Before you call the ModifyDiskDeployment operation, make sure that you fully understand the billing methods and prices of disks and dedicated block storage clusters. In addition, make sure that the dedicated block storage clusters are unexpired and your account has no overdue payments. For more information, see [Dedicated block storage cluster](~~208883~~) and [Block storage devices](~~179022~~).
33807
+ * Take note of the following items:
33808
+ * * The disks and a dedicated block storage cluster to which you want to migrate the disk must be in the same zone.
33809
+ * * You can migrate only pay-as-you-go disks. If you want to migrate subscription disks, change the disks to pay-as-you-go disks first. For more information, see [Change the billing method of a disk](~~145018~~).
33810
+ * * The specifications of disks that you want to migrate to a destination block storage cluster must the same as the disk specifications that the destination dedicated block storage cluster supports. During migration, you can change the specifications of the disks to ensure specification consistency.
33811
+ * * The disk must be in the **In Use** (In_Use) or **Available** (Available) state.
33812
+ * * If the disk is attached to an Elastic Compute Service (ECS) instance, the instance must be in the **Running** (Running) or **Stopped** (Stopped) state. The ECS instance cannot be in the Expired state.
33813
+ * * The performance level of an enhanced SSD (ESSD) is limited by the ESSD disk size. If you cannot upgrade the performance level of an ESSD, you can resize the ESSD. For more information, see [ResizeDisk](~~25522~~) and [ESSDs](~~122389~~).
33814
+ * * An account can perform up to five disk migration tasks in the same region at the same time.
33815
+ * * When a disk is being migrated, you cannot cancel the migration task, create snapshots for the disk, change the disk configurations, resize the disk, mount the disk, unmount the disk, or re-initialize the disk.
33816
+ * > After you migrate a disk to a destination cluster by calling the ModifyDiskDeployment operation, the billing method, disk specifications, and capabilities of the destination cluster take effect immediately on the disk. Alibaba Cloud charges the disk based on the disk category and performance level. For more information, see [Dedicated block storage cluster](~~208883~~) and [Block storage devices](~~179022~~).
33817
+ *
33818
+ * @param request ModifyDiskDeploymentRequest
33819
+ * @param runtime runtime options for this request RuntimeOptions
33820
+ * @return ModifyDiskDeploymentResponse
33821
+ */
33194
33822
  modifyDiskDeploymentWithOptions(request: ModifyDiskDeploymentRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskDeploymentResponse>;
33823
+ /**
33824
+ * ### [](#)Usage notes
33825
+ * > The Dedicated Block Storage Cluster feature is available in the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Heyuan), Indonesia (Jakarta), Germany (Frankfurt), and China South 1 Finance.
33826
+ * Before you call the ModifyDiskDeployment operation, make sure that you fully understand the billing methods and prices of disks and dedicated block storage clusters. In addition, make sure that the dedicated block storage clusters are unexpired and your account has no overdue payments. For more information, see [Dedicated block storage cluster](~~208883~~) and [Block storage devices](~~179022~~).
33827
+ * Take note of the following items:
33828
+ * * The disks and a dedicated block storage cluster to which you want to migrate the disk must be in the same zone.
33829
+ * * You can migrate only pay-as-you-go disks. If you want to migrate subscription disks, change the disks to pay-as-you-go disks first. For more information, see [Change the billing method of a disk](~~145018~~).
33830
+ * * The specifications of disks that you want to migrate to a destination block storage cluster must the same as the disk specifications that the destination dedicated block storage cluster supports. During migration, you can change the specifications of the disks to ensure specification consistency.
33831
+ * * The disk must be in the **In Use** (In_Use) or **Available** (Available) state.
33832
+ * * If the disk is attached to an Elastic Compute Service (ECS) instance, the instance must be in the **Running** (Running) or **Stopped** (Stopped) state. The ECS instance cannot be in the Expired state.
33833
+ * * The performance level of an enhanced SSD (ESSD) is limited by the ESSD disk size. If you cannot upgrade the performance level of an ESSD, you can resize the ESSD. For more information, see [ResizeDisk](~~25522~~) and [ESSDs](~~122389~~).
33834
+ * * An account can perform up to five disk migration tasks in the same region at the same time.
33835
+ * * When a disk is being migrated, you cannot cancel the migration task, create snapshots for the disk, change the disk configurations, resize the disk, mount the disk, unmount the disk, or re-initialize the disk.
33836
+ * > After you migrate a disk to a destination cluster by calling the ModifyDiskDeployment operation, the billing method, disk specifications, and capabilities of the destination cluster take effect immediately on the disk. Alibaba Cloud charges the disk based on the disk category and performance level. For more information, see [Dedicated block storage cluster](~~208883~~) and [Block storage devices](~~179022~~).
33837
+ *
33838
+ * @param request ModifyDiskDeploymentRequest
33839
+ * @return ModifyDiskDeploymentResponse
33840
+ */
33195
33841
  modifyDiskDeployment(request: ModifyDiskDeploymentRequest): Promise<ModifyDiskDeploymentResponse>;
33196
33842
  /**
33197
33843
  * ## Usage notes
@@ -33293,17 +33939,18 @@ export default class Client extends OpenApi {
33293
33939
  */
33294
33940
  modifyImageShareGroupPermission(request: ModifyImageShareGroupPermissionRequest): Promise<ModifyImageShareGroupPermissionResponse>;
33295
33941
  /**
33296
- * When you call this operation, take note of the following items:
33297
- * * You can share only your own custom images with other Alibaba Cloud accounts.
33298
- * * You can share a custom image with up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N or RemoveAccount.N parameter. If you specify more than 10 account IDs, the parameter will be ignored.
33299
- * * You can share a custom image with up to 50 Alibaba Cloud accounts.
33300
- * * After you create an instance from a shared custom image by calling the [RunInstances](~~63440~~) operation, you cannot call the [ReInitDisk](~~25519~~) operation to reinitialize the system disk of the instance if the image owner unshares the image or calls the [DeleteImage](~~25537~~) operation to delete the image.
33942
+ * ## [](#)Usage notes
33943
+ * Take note of the following items:
33944
+ * * You can share only your own custom images to other Alibaba Cloud accounts.
33945
+ * * You can share a custom image to up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using AddAccount.N or RemoveAccount.N. If you specify more than 10 account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
33946
+ * * You can share a custom image to up to 50 Alibaba Cloud accounts.
33947
+ * * If an Elastic Compute Service (ECS) instance was created ([RunInstances](~~63440~~)) from a shared image, you cannot re-initialize the instance ([ReInitDisk](~~25519~~)) after the image owner unshares or deletes the image ([DeleteImage](~~25537~~)).
33301
33948
  * When you publish or unpublish a community image, take note of the following items:
33302
- * * Alibaba Cloud provides only the platform on which community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you read and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~)
33949
+ * * Alibaba Cloud provides only the platform on which community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~).
33303
33950
  * * You cannot publish encrypted images as community images.
33304
- * * All community images are publicly available. All Alibaba Cloud accounts that reside in the same region as a community image can access the image.
33951
+ * * Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
33305
33952
  * * You cannot share, export, or copy community images.
33306
- * * After a community image is unpublished, it is no longer available to other Alibaba Cloud accounts. If a custom image is shared to other Alibaba cloud accounts before it is published as a community image, the accounts can still use the image after it is unpublished.
33953
+ * * After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
33307
33954
  *
33308
33955
  * @param request ModifyImageSharePermissionRequest
33309
33956
  * @param runtime runtime options for this request RuntimeOptions
@@ -33311,17 +33958,18 @@ export default class Client extends OpenApi {
33311
33958
  */
33312
33959
  modifyImageSharePermissionWithOptions(request: ModifyImageSharePermissionRequest, runtime: $Util.RuntimeOptions): Promise<ModifyImageSharePermissionResponse>;
33313
33960
  /**
33314
- * When you call this operation, take note of the following items:
33315
- * * You can share only your own custom images with other Alibaba Cloud accounts.
33316
- * * You can share a custom image with up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N or RemoveAccount.N parameter. If you specify more than 10 account IDs, the parameter will be ignored.
33317
- * * You can share a custom image with up to 50 Alibaba Cloud accounts.
33318
- * * After you create an instance from a shared custom image by calling the [RunInstances](~~63440~~) operation, you cannot call the [ReInitDisk](~~25519~~) operation to reinitialize the system disk of the instance if the image owner unshares the image or calls the [DeleteImage](~~25537~~) operation to delete the image.
33961
+ * ## [](#)Usage notes
33962
+ * Take note of the following items:
33963
+ * * You can share only your own custom images to other Alibaba Cloud accounts.
33964
+ * * You can share a custom image to up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using AddAccount.N or RemoveAccount.N. If you specify more than 10 account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
33965
+ * * You can share a custom image to up to 50 Alibaba Cloud accounts.
33966
+ * * If an Elastic Compute Service (ECS) instance was created ([RunInstances](~~63440~~)) from a shared image, you cannot re-initialize the instance ([ReInitDisk](~~25519~~)) after the image owner unshares or deletes the image ([DeleteImage](~~25537~~)).
33319
33967
  * When you publish or unpublish a community image, take note of the following items:
33320
- * * Alibaba Cloud provides only the platform on which community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you read and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~)
33968
+ * * Alibaba Cloud provides only the platform on which community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~).
33321
33969
  * * You cannot publish encrypted images as community images.
33322
- * * All community images are publicly available. All Alibaba Cloud accounts that reside in the same region as a community image can access the image.
33970
+ * * Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
33323
33971
  * * You cannot share, export, or copy community images.
33324
- * * After a community image is unpublished, it is no longer available to other Alibaba Cloud accounts. If a custom image is shared to other Alibaba cloud accounts before it is published as a community image, the accounts can still use the image after it is unpublished.
33972
+ * * After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
33325
33973
  *
33326
33974
  * @param request ModifyImageSharePermissionRequest
33327
33975
  * @return ModifyImageSharePermissionResponse
@@ -33553,16 +34201,17 @@ export default class Client extends OpenApi {
33553
34201
  */
33554
34202
  modifyInstanceNetworkSpec(request: ModifyInstanceNetworkSpecRequest): Promise<ModifyInstanceNetworkSpecResponse>;
33555
34203
  /**
34204
+ * ## [](#)Usage notes
33556
34205
  * For information about how to use ECS SDK for Python to change resource configurations, see [Query available resources for configuration changes](~~109517~~).
33557
34206
  * Take note of the following items:
33558
34207
  * * Make sure that you have no overdue payments in your account.
33559
- * * You can modify the public bandwidth of an instance only when the instance is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
33560
- * * Before you change the instance type of a pay-as-you-go instance, you can call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change.
34208
+ * * You can adjust the public bandwidth of an instance only when the instance is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
34209
+ * * Before you change the instance type of a pay-as-you-go instance, call the [DescribeResourcesModification](~~66187~~) operation to query compatible instance types.
33561
34210
  * * You can change the instance type of an instance only when the instance is in the **Stopped** (`Stopped`) state.
33562
34211
  * * The instance type and the public bandwidth of an instance cannot be changed together.
33563
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy specified for your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
33564
- * * Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
33565
- * * Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
34212
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
34213
+ * * In each region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
34214
+ * * In each region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
33566
34215
  *
33567
34216
  * @param request ModifyInstanceSpecRequest
33568
34217
  * @param runtime runtime options for this request RuntimeOptions
@@ -33570,16 +34219,17 @@ export default class Client extends OpenApi {
33570
34219
  */
33571
34220
  modifyInstanceSpecWithOptions(request: ModifyInstanceSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceSpecResponse>;
33572
34221
  /**
34222
+ * ## [](#)Usage notes
33573
34223
  * For information about how to use ECS SDK for Python to change resource configurations, see [Query available resources for configuration changes](~~109517~~).
33574
34224
  * Take note of the following items:
33575
34225
  * * Make sure that you have no overdue payments in your account.
33576
- * * You can modify the public bandwidth of an instance only when the instance is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
33577
- * * Before you change the instance type of a pay-as-you-go instance, you can call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change.
34226
+ * * You can adjust the public bandwidth of an instance only when the instance is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
34227
+ * * Before you change the instance type of a pay-as-you-go instance, call the [DescribeResourcesModification](~~66187~~) operation to query compatible instance types.
33578
34228
  * * You can change the instance type of an instance only when the instance is in the **Stopped** (`Stopped`) state.
33579
34229
  * * The instance type and the public bandwidth of an instance cannot be changed together.
33580
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy specified for your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
33581
- * * Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
33582
- * * Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
34230
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
34231
+ * * In each region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
34232
+ * * In each region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
33583
34233
  *
33584
34234
  * @param request ModifyInstanceSpecRequest
33585
34235
  * @return ModifyInstanceSpecResponse
@@ -33607,17 +34257,18 @@ export default class Client extends OpenApi {
33607
34257
  */
33608
34258
  modifyInstanceVncPasswd(request: ModifyInstanceVncPasswdRequest): Promise<ModifyInstanceVncPasswdResponse>;
33609
34259
  /**
33610
- * The instance must be in the **Stopped** state.``
34260
+ * ## [](#)Usage notes
34261
+ * The instance that you want to manage must be in the **Stopped** (`Stopped`) state.
33611
34262
  * * When you call this operation to change the private IP address or vSwitch of an instance, take note of the following items:
33612
34263
  * * If the instance is a new instance, you must restart the instance before you call this operation.
33613
- * * After the private IP address or vSwitch of the instance is changed, you must restart the instance before you call this operation again.
34264
+ * * After the private IP address or vSwitch of the instance is changed, you must restart the instance before you can recall this operation.
33614
34265
  * * When you call this operation to change the VPC of an instance, take note of the following items:
33615
34266
  * * **Instance:**
33616
34267
  * * The instance cannot be associated with Server Load Balancer (SLB) instances.
33617
- * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [ECS instance lifecycle](~~25380~~).
34268
+ * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [Instance lifecycle](~~25380~~).
33618
34269
  * * The instance cannot be used in other Alibaba Cloud services. For example, the instance cannot be in the process of being migrated or having its VPC changed, or the databases deployed on the instance cannot be managed by Data Transmission Service (DTS).
33619
34270
  * * **Network:**
33620
- * * The cut-through mode or the multi-EIP-to-ENI mode cannot be enabled for the instance.
34271
+ * * The cut-through mode or the multi-elastic IP address (EIP)-to-elastic network interface (ENI) mode cannot be enabled for the instance.
33621
34272
  * * The instance cannot be associated with a high-availability virtual IP address (HAVIP).
33622
34273
  * * The vSwitch of the instance cannot be associated with a custom route table.
33623
34274
  * * Global Accelerator (GA) cannot be activated for the instance.
@@ -33626,14 +34277,13 @@ export default class Client extends OpenApi {
33626
34277
  * * The primary ENI of the instance cannot be associated with multiple IP addresses.
33627
34278
  * * The new vSwitch that you specify must belong to the new VPC.
33628
34279
  * * The original and new vSwitches must reside in the same zone.
33629
- * * If you assign a private IP address to the primary ENI of the instance, the private IP address must an idle IP address within the CIDR block of the new vSwitch. If you do not assign a private IP address to the primary ENI of the instance, a private IP address is randomly assigned to the ENI. Sufficient IP addresses must be available in the CIDR block of the new vSwitch.
33630
- * * If advanced features are enabled for the new VPC, take note of the instance families that do not support advanced VPC features. For more information, see [Instance families that do not support advanced VPC features](~~163466~~).
34280
+ * * If you assign a private IP address to the primary ENI of the instance, the private IP address must be an idle IP address within the CIDR block of the new vSwitch. If you do not assign a private IP address to the primary ENI of the instance, a private IP address is randomly assigned to the ENI. Make sure that sufficient IP addresses are available in the CIDR block of the new vSwitch.
33631
34281
  * * The Alibaba Cloud account that owns the new VPC cannot share the VPC with other accounts.
33632
34282
  * * **Security group (SecurityGroupId.N):**
33633
34283
  * * All security groups must be of the same type.
33634
- * * The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see [Limits](~~25412~~).
34284
+ * * The valid values of N vary based on the maximum number of security groups to which an instance can belong. For more information, see the "Security group limits" section in [Limits](~~25412~~).
33635
34285
  * * The security groups that you specify must belong to the new VPC.
33636
- * * You can switch the instance to a security group of a different type. If you want to switch an instance to a security group of a different type, we recommend that you familiarize yourself with the differences between the rule configurations of the two security group types to avoid impacts on the instance network. For more information, see [Overview](~~25387~~).
34286
+ * * You can switch the instance to security groups of a different type. To ensure network connectivity, we recommend that you understand the differences in rule configurations of the two security group types before you switch an instance to security groups of a different type. For more information, see [Overview](~~25387~~).
33637
34287
  *
33638
34288
  * @param request ModifyInstanceVpcAttributeRequest
33639
34289
  * @param runtime runtime options for this request RuntimeOptions
@@ -33641,17 +34291,18 @@ export default class Client extends OpenApi {
33641
34291
  */
33642
34292
  modifyInstanceVpcAttributeWithOptions(request: ModifyInstanceVpcAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceVpcAttributeResponse>;
33643
34293
  /**
33644
- * The instance must be in the **Stopped** state.``
34294
+ * ## [](#)Usage notes
34295
+ * The instance that you want to manage must be in the **Stopped** (`Stopped`) state.
33645
34296
  * * When you call this operation to change the private IP address or vSwitch of an instance, take note of the following items:
33646
34297
  * * If the instance is a new instance, you must restart the instance before you call this operation.
33647
- * * After the private IP address or vSwitch of the instance is changed, you must restart the instance before you call this operation again.
34298
+ * * After the private IP address or vSwitch of the instance is changed, you must restart the instance before you can recall this operation.
33648
34299
  * * When you call this operation to change the VPC of an instance, take note of the following items:
33649
34300
  * * **Instance:**
33650
34301
  * * The instance cannot be associated with Server Load Balancer (SLB) instances.
33651
- * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [ECS instance lifecycle](~~25380~~).
34302
+ * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [Instance lifecycle](~~25380~~).
33652
34303
  * * The instance cannot be used in other Alibaba Cloud services. For example, the instance cannot be in the process of being migrated or having its VPC changed, or the databases deployed on the instance cannot be managed by Data Transmission Service (DTS).
33653
34304
  * * **Network:**
33654
- * * The cut-through mode or the multi-EIP-to-ENI mode cannot be enabled for the instance.
34305
+ * * The cut-through mode or the multi-elastic IP address (EIP)-to-elastic network interface (ENI) mode cannot be enabled for the instance.
33655
34306
  * * The instance cannot be associated with a high-availability virtual IP address (HAVIP).
33656
34307
  * * The vSwitch of the instance cannot be associated with a custom route table.
33657
34308
  * * Global Accelerator (GA) cannot be activated for the instance.
@@ -33660,20 +34311,54 @@ export default class Client extends OpenApi {
33660
34311
  * * The primary ENI of the instance cannot be associated with multiple IP addresses.
33661
34312
  * * The new vSwitch that you specify must belong to the new VPC.
33662
34313
  * * The original and new vSwitches must reside in the same zone.
33663
- * * If you assign a private IP address to the primary ENI of the instance, the private IP address must an idle IP address within the CIDR block of the new vSwitch. If you do not assign a private IP address to the primary ENI of the instance, a private IP address is randomly assigned to the ENI. Sufficient IP addresses must be available in the CIDR block of the new vSwitch.
33664
- * * If advanced features are enabled for the new VPC, take note of the instance families that do not support advanced VPC features. For more information, see [Instance families that do not support advanced VPC features](~~163466~~).
34314
+ * * If you assign a private IP address to the primary ENI of the instance, the private IP address must be an idle IP address within the CIDR block of the new vSwitch. If you do not assign a private IP address to the primary ENI of the instance, a private IP address is randomly assigned to the ENI. Make sure that sufficient IP addresses are available in the CIDR block of the new vSwitch.
33665
34315
  * * The Alibaba Cloud account that owns the new VPC cannot share the VPC with other accounts.
33666
34316
  * * **Security group (SecurityGroupId.N):**
33667
34317
  * * All security groups must be of the same type.
33668
- * * The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see [Limits](~~25412~~).
34318
+ * * The valid values of N vary based on the maximum number of security groups to which an instance can belong. For more information, see the "Security group limits" section in [Limits](~~25412~~).
33669
34319
  * * The security groups that you specify must belong to the new VPC.
33670
- * * You can switch the instance to a security group of a different type. If you want to switch an instance to a security group of a different type, we recommend that you familiarize yourself with the differences between the rule configurations of the two security group types to avoid impacts on the instance network. For more information, see [Overview](~~25387~~).
34320
+ * * You can switch the instance to security groups of a different type. To ensure network connectivity, we recommend that you understand the differences in rule configurations of the two security group types before you switch an instance to security groups of a different type. For more information, see [Overview](~~25387~~).
33671
34321
  *
33672
34322
  * @param request ModifyInstanceVpcAttributeRequest
33673
34323
  * @return ModifyInstanceVpcAttributeResponse
33674
34324
  */
33675
34325
  modifyInstanceVpcAttribute(request: ModifyInstanceVpcAttributeRequest): Promise<ModifyInstanceVpcAttributeResponse>;
34326
+ /**
34327
+ * * You can modify the execution information of a command that is run in one of the following modes:
34328
+ * * Period: The command is run on a schedule.
34329
+ * * NextRebootOnly: The command is run the next time the instance starts.
34330
+ * * EveryReboot: The command is run every time the instance starts.
34331
+ * * You can modify the execution information of a command that is in one of the following status (For more information, see the [InvocationStatus](~~64840~~) response parameter of `DescribeInvocations`.):
34332
+ * * Pending: The command is being verified or sent. When the execution status on at least one instance is Pending, the overall execution status is Pending.
34333
+ * * Running: The command is being run on the instance. When the execution status on at least one instance is Running, the overall execution status is Running.
34334
+ * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution status on at least one instance is Scheduled, the overall execution status is Scheduled.
34335
+ * * Stopping: The command that is running is being stopped. When the execution status on at least one instance is Stopping, the overall execution status is Stopping.
34336
+ * * The Cloud Assistant Agent version that is installed on the instance must be later than one of the following versions to support the ModifyInvocationAttribute operation. If the `ClientNeedUpgrade` error code is returned, update Cloud Assistant Agent to the latest version.
34337
+ * * Linux: 2.2.3.541
34338
+ * * Windows: 2.1.3.541
34339
+ *
34340
+ * @param tmpReq ModifyInvocationAttributeRequest
34341
+ * @param runtime runtime options for this request RuntimeOptions
34342
+ * @return ModifyInvocationAttributeResponse
34343
+ */
33676
34344
  modifyInvocationAttributeWithOptions(tmpReq: ModifyInvocationAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInvocationAttributeResponse>;
34345
+ /**
34346
+ * * You can modify the execution information of a command that is run in one of the following modes:
34347
+ * * Period: The command is run on a schedule.
34348
+ * * NextRebootOnly: The command is run the next time the instance starts.
34349
+ * * EveryReboot: The command is run every time the instance starts.
34350
+ * * You can modify the execution information of a command that is in one of the following status (For more information, see the [InvocationStatus](~~64840~~) response parameter of `DescribeInvocations`.):
34351
+ * * Pending: The command is being verified or sent. When the execution status on at least one instance is Pending, the overall execution status is Pending.
34352
+ * * Running: The command is being run on the instance. When the execution status on at least one instance is Running, the overall execution status is Running.
34353
+ * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution status on at least one instance is Scheduled, the overall execution status is Scheduled.
34354
+ * * Stopping: The command that is running is being stopped. When the execution status on at least one instance is Stopping, the overall execution status is Stopping.
34355
+ * * The Cloud Assistant Agent version that is installed on the instance must be later than one of the following versions to support the ModifyInvocationAttribute operation. If the `ClientNeedUpgrade` error code is returned, update Cloud Assistant Agent to the latest version.
34356
+ * * Linux: 2.2.3.541
34357
+ * * Windows: 2.1.3.541
34358
+ *
34359
+ * @param request ModifyInvocationAttributeRequest
34360
+ * @return ModifyInvocationAttributeResponse
34361
+ */
33677
34362
  modifyInvocationAttribute(request: ModifyInvocationAttributeRequest): Promise<ModifyInvocationAttributeResponse>;
33678
34363
  /**
33679
34364
  * ## Debugging
@@ -33727,13 +34412,12 @@ export default class Client extends OpenApi {
33727
34412
  */
33728
34413
  modifyPhysicalConnectionAttribute(request: ModifyPhysicalConnectionAttributeRequest): Promise<ModifyPhysicalConnectionAttributeResponse>;
33729
34414
  /**
33730
- * ## Description
33731
- * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](https://www.alibabacloud.com/help/doc-detail/40637.htm#section-jua-0tj-q5m) section in Network FAQ.
34415
+ * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](~~40637~~#section-jua-0tj-q5m) section in the "Network FAQ" topic.
33732
34416
  * * When you add or delete an entry, you cannot specify duplicate CIDR blocks. Examples:
33733
- * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. These two CIDR blocks are the same.
33734
- * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. These two CIDR blocks are the same.
33735
- * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, the entry to be deleted cannot have the 10.0.0.0/8 CIDR block specified.
33736
- * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) in the entry.
34417
+ * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. The two CIDR blocks are the same.
34418
+ * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. The two CIDR blocks are the same.
34419
+ * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, make sure the 10.0.0.0/8 CIDR block is not specified in an entry to be deleted.
34420
+ * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) for the entry.
33737
34421
  *
33738
34422
  * @param request ModifyPrefixListRequest
33739
34423
  * @param runtime runtime options for this request RuntimeOptions
@@ -33741,31 +34425,29 @@ export default class Client extends OpenApi {
33741
34425
  */
33742
34426
  modifyPrefixListWithOptions(request: ModifyPrefixListRequest, runtime: $Util.RuntimeOptions): Promise<ModifyPrefixListResponse>;
33743
34427
  /**
33744
- * ## Description
33745
- * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](https://www.alibabacloud.com/help/doc-detail/40637.htm#section-jua-0tj-q5m) section in Network FAQ.
34428
+ * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](~~40637~~#section-jua-0tj-q5m) section in the "Network FAQ" topic.
33746
34429
  * * When you add or delete an entry, you cannot specify duplicate CIDR blocks. Examples:
33747
- * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. These two CIDR blocks are the same.
33748
- * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. These two CIDR blocks are the same.
33749
- * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, the entry to be deleted cannot have the 10.0.0.0/8 CIDR block specified.
33750
- * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) in the entry.
34430
+ * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. The two CIDR blocks are the same.
34431
+ * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. The two CIDR blocks are the same.
34432
+ * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, make sure the 10.0.0.0/8 CIDR block is not specified in an entry to be deleted.
34433
+ * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) for the entry.
33751
34434
  *
33752
34435
  * @param request ModifyPrefixListRequest
33753
34436
  * @return ModifyPrefixListResponse
33754
34437
  */
33755
34438
  modifyPrefixList(request: ModifyPrefixListRequest): Promise<ModifyPrefixListResponse>;
33756
34439
  /**
33757
- * Before you call this operation, we recommend that you familiarize yourself with the billing methods, pricing schedule, and refund rules of [ECS](https://www.alibabacloud.com/product/ecs#pricing). For more information, see [Refund rules for real-time configuration downgrade](~~201955~~).
33758
- * Before you change the instance type of a subscription instance, you can call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change the instance. You can use ECS SDK for Python to query the instance types to which you can change. For more information, see [Query available resources for configuration changes](~~109517~~).
33759
- * When you call this operation, take note of the following items:
33760
- * * You cannot change the instance type of an expired instance. Renew the instance and try again.
34440
+ * ## [](#)Usage notes
34441
+ * Before you call this operation, we recommend that you familiarize yourself with the billing methods, pricing schedule, and refund rules of [ECS](https://www.alibabacloud.com/product/ecs#pricing). For information about the refund rules, see [Rules for unsubscribing from resources](~~476339~~).
34442
+ * Before you change the instance type of a subscription instance, call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change the instance. You can use ECS SDK for Python. For more information, see [Query available resources for configuration changes](~~109517~~).
34443
+ * Take note of the following items:
34444
+ * * To change the instance type of an expired instance, you must first renew the instance.
33761
34445
  * * When you downgrade the instance type of an instance, take note of the following items:
33762
- * * The instance must be in the `Stopped` state.****
33763
- * * You must specify the operation type by setting `OperatorType` to downgrade.
33764
- * * You can downgrade the configurations of an instance up to three times. Therefore, up to three refunds for the price difference can be made for an instance. Downgrade operations include instance type downgrades, bandwidth configuration downgrades, and the change of the disk billing method from subscription to pay-as-you-go.
33765
- * * The price difference is refunded to the payment account you used. Vouchers that have been redeemed during purchase are not refundable.
33766
- * * This operation is asynchronous. It takes 5 to 10 seconds for the instance type to change. You must restart the instance by calling the RebootInstance operation or by using the ECS console for the instance type change to take effect. If you restart only the operating system of the instance, the instance type change does not take effect.
34446
+ * * The instance must be in the **Stopped** (`Stopped`) state.
34447
+ * * The price difference is refunded to the payment account you used. Vouchers that have been redeemed are not refundable.
34448
+ * * The operation is asynchronous. Wait 5 to 10 seconds for the instance type change to complete. Then, restart the instance by calling the RebootInstance operation or by using the ECS console for the instance type change to take effect. If you restart only the operating system of the instance, the instance type change does not take effect.
33767
34449
  * * If the instance is in the **Stopped** state, you only need to start the instance. You do not need to restart the instance after it enters the Running state.
33768
- * * If `RebootWhenFinished` is set to true for the instance, you do not need to manually restart the instance.
34450
+ * * If `RebootWhenFinished` is set to true for the instance, you do not need to restart the instance.
33769
34451
  *
33770
34452
  * @param request ModifyPrepayInstanceSpecRequest
33771
34453
  * @param runtime runtime options for this request RuntimeOptions
@@ -33773,18 +34455,17 @@ export default class Client extends OpenApi {
33773
34455
  */
33774
34456
  modifyPrepayInstanceSpecWithOptions(request: ModifyPrepayInstanceSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyPrepayInstanceSpecResponse>;
33775
34457
  /**
33776
- * Before you call this operation, we recommend that you familiarize yourself with the billing methods, pricing schedule, and refund rules of [ECS](https://www.alibabacloud.com/product/ecs#pricing). For more information, see [Refund rules for real-time configuration downgrade](~~201955~~).
33777
- * Before you change the instance type of a subscription instance, you can call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change the instance. You can use ECS SDK for Python to query the instance types to which you can change. For more information, see [Query available resources for configuration changes](~~109517~~).
33778
- * When you call this operation, take note of the following items:
33779
- * * You cannot change the instance type of an expired instance. Renew the instance and try again.
34458
+ * ## [](#)Usage notes
34459
+ * Before you call this operation, we recommend that you familiarize yourself with the billing methods, pricing schedule, and refund rules of [ECS](https://www.alibabacloud.com/product/ecs#pricing). For information about the refund rules, see [Rules for unsubscribing from resources](~~476339~~).
34460
+ * Before you change the instance type of a subscription instance, call the [DescribeResourcesModification](~~66187~~) operation to query the instance types to which you can change the instance. You can use ECS SDK for Python. For more information, see [Query available resources for configuration changes](~~109517~~).
34461
+ * Take note of the following items:
34462
+ * * To change the instance type of an expired instance, you must first renew the instance.
33780
34463
  * * When you downgrade the instance type of an instance, take note of the following items:
33781
- * * The instance must be in the `Stopped` state.****
33782
- * * You must specify the operation type by setting `OperatorType` to downgrade.
33783
- * * You can downgrade the configurations of an instance up to three times. Therefore, up to three refunds for the price difference can be made for an instance. Downgrade operations include instance type downgrades, bandwidth configuration downgrades, and the change of the disk billing method from subscription to pay-as-you-go.
33784
- * * The price difference is refunded to the payment account you used. Vouchers that have been redeemed during purchase are not refundable.
33785
- * * This operation is asynchronous. It takes 5 to 10 seconds for the instance type to change. You must restart the instance by calling the RebootInstance operation or by using the ECS console for the instance type change to take effect. If you restart only the operating system of the instance, the instance type change does not take effect.
34464
+ * * The instance must be in the **Stopped** (`Stopped`) state.
34465
+ * * The price difference is refunded to the payment account you used. Vouchers that have been redeemed are not refundable.
34466
+ * * The operation is asynchronous. Wait 5 to 10 seconds for the instance type change to complete. Then, restart the instance by calling the RebootInstance operation or by using the ECS console for the instance type change to take effect. If you restart only the operating system of the instance, the instance type change does not take effect.
33786
34467
  * * If the instance is in the **Stopped** state, you only need to start the instance. You do not need to restart the instance after it enters the Running state.
33787
- * * If `RebootWhenFinished` is set to true for the instance, you do not need to manually restart the instance.
34468
+ * * If `RebootWhenFinished` is set to true for the instance, you do not need to restart the instance.
33788
34469
  *
33789
34470
  * @param request ModifyPrepayInstanceSpecRequest
33790
34471
  * @return ModifyPrepayInstanceSpecResponse
@@ -33890,12 +34571,13 @@ export default class Client extends OpenApi {
33890
34571
  */
33891
34572
  modifySecurityGroupPolicy(request: ModifySecurityGroupPolicyRequest): Promise<ModifySecurityGroupPolicyResponse>;
33892
34573
  /**
33893
- * In the security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
33894
- * When you modify the rules of a security group by specifying the rule IDs, take note of the following limits:
33895
- * * A security group authorization object can be one of the following types: IP address or CIDR block, security group, or prefix list. The type of an existing security group authorization object cannot be changed. If the original authorization object is an IP address, you can change it to another IP address or a CIDR block, but not to a security group or prefix list.
33896
- * * The IP address family of the authorization object cannot be changed. For example, if the original authorization object is an IPv4 CIDR block, you cannot change it to an IPv6 CIDR block. If the original authorization object is a prefix list of an IPv4 address family, you cannot change it to a prefix list of an IPv6 address family.
33897
- * * The modified security group rule cannot be the same as other existing rules.
33898
- * * You cannot delete the value of a non-empty parameter. We recommend that you create a new rule and delete the original rule.
34574
+ * ## [](#)Usage notes
34575
+ * In security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
34576
+ * Take note of the following items:
34577
+ * * An authorization object in a security group rule can be one of the following types: IP address or CIDR block, security group, or prefix list. You cannot call this operation to change the type of an existing authorization object. For example, if an authorization object is an IP address, you can change the authorization object to another IP address or a CIDR block, but you cannot change the authorization object to a security group or prefix list.
34578
+ * * You cannot change the IP address family of an existing authorization object. For example, if an authorization object is an IPv4 CIDR block, you cannot change the authorization object to an IPv6 CIDR block. If an authorization object is a prefix list of the IPv4 address family, you cannot change the authorization object to a prefix list of the IPv6 address family.
34579
+ * * The new security group rule after modification cannot be the same as other existing rules.
34580
+ * * You cannot delete the value of a non-empty parameter. If you want to delete the values of non-empty parameters, we recommend that you create another rule and delete the original rule.
33899
34581
  *
33900
34582
  * @param request ModifySecurityGroupRuleRequest
33901
34583
  * @param runtime runtime options for this request RuntimeOptions
@@ -33903,12 +34585,13 @@ export default class Client extends OpenApi {
33903
34585
  */
33904
34586
  modifySecurityGroupRuleWithOptions(request: ModifySecurityGroupRuleRequest, runtime: $Util.RuntimeOptions): Promise<ModifySecurityGroupRuleResponse>;
33905
34587
  /**
33906
- * In the security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
33907
- * When you modify the rules of a security group by specifying the rule IDs, take note of the following limits:
33908
- * * A security group authorization object can be one of the following types: IP address or CIDR block, security group, or prefix list. The type of an existing security group authorization object cannot be changed. If the original authorization object is an IP address, you can change it to another IP address or a CIDR block, but not to a security group or prefix list.
33909
- * * The IP address family of the authorization object cannot be changed. For example, if the original authorization object is an IPv4 CIDR block, you cannot change it to an IPv6 CIDR block. If the original authorization object is a prefix list of an IPv4 address family, you cannot change it to a prefix list of an IPv6 address family.
33910
- * * The modified security group rule cannot be the same as other existing rules.
33911
- * * You cannot delete the value of a non-empty parameter. We recommend that you create a new rule and delete the original rule.
34588
+ * ## [](#)Usage notes
34589
+ * In security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
34590
+ * Take note of the following items:
34591
+ * * An authorization object in a security group rule can be one of the following types: IP address or CIDR block, security group, or prefix list. You cannot call this operation to change the type of an existing authorization object. For example, if an authorization object is an IP address, you can change the authorization object to another IP address or a CIDR block, but you cannot change the authorization object to a security group or prefix list.
34592
+ * * You cannot change the IP address family of an existing authorization object. For example, if an authorization object is an IPv4 CIDR block, you cannot change the authorization object to an IPv6 CIDR block. If an authorization object is a prefix list of the IPv4 address family, you cannot change the authorization object to a prefix list of the IPv6 address family.
34593
+ * * The new security group rule after modification cannot be the same as other existing rules.
34594
+ * * You cannot delete the value of a non-empty parameter. If you want to delete the values of non-empty parameters, we recommend that you create another rule and delete the original rule.
33912
34595
  *
33913
34596
  * @param request ModifySecurityGroupRuleRequest
33914
34597
  * @return ModifySecurityGroupRuleResponse
@@ -34275,7 +34958,7 @@ export default class Client extends OpenApi {
34275
34958
  removeTagsWithOptions(request: RemoveTagsRequest, runtime: $Util.RuntimeOptions): Promise<RemoveTagsResponse>;
34276
34959
  removeTags(request: RemoveTagsRequest): Promise<RemoveTagsResponse>;
34277
34960
  /**
34278
- * The IDs of dedicated hosts. You can specify the IDs of up to 100 subscription dedicated hosts. Specify the dedicated host IDs in a JSON array. Example: `["dh-xxxxxxxxx", "dh-yyyyyyyyy", … "dh-zzzzzzzzz"]`. Separate the IDs with commas (,).
34961
+ * Valid vouchers can be applied when you renew the subscription plan dedicated hosts. In order to use vouchers, make sure that your account supports the credit card payment method.
34279
34962
  *
34280
34963
  * @param request RenewDedicatedHostsRequest
34281
34964
  * @param runtime runtime options for this request RuntimeOptions
@@ -34283,7 +34966,7 @@ export default class Client extends OpenApi {
34283
34966
  */
34284
34967
  renewDedicatedHostsWithOptions(request: RenewDedicatedHostsRequest, runtime: $Util.RuntimeOptions): Promise<RenewDedicatedHostsResponse>;
34285
34968
  /**
34286
- * The IDs of dedicated hosts. You can specify the IDs of up to 100 subscription dedicated hosts. Specify the dedicated host IDs in a JSON array. Example: `["dh-xxxxxxxxx", "dh-yyyyyyyyy", … "dh-zzzzzzzzz"]`. Separate the IDs with commas (,).
34969
+ * Valid vouchers can be applied when you renew the subscription plan dedicated hosts. In order to use vouchers, make sure that your account supports the credit card payment method.
34287
34970
  *
34288
34971
  * @param request RenewDedicatedHostsRequest
34289
34972
  * @return RenewDedicatedHostsResponse
@@ -34544,23 +35227,23 @@ export default class Client extends OpenApi {
34544
35227
  */
34545
35228
  revokeSecurityGroupEgress(request: RevokeSecurityGroupEgressRequest): Promise<RevokeSecurityGroupEgressResponse>;
34546
35229
  /**
34547
- * ## Usage notes
35230
+ * ## [](#)Usage notes
34548
35231
  * Unlike the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operations, RunCommand can be used to create and run a command in a single request.
34549
35232
  * Take note of the following items:
34550
35233
  * * The instances on which you want to run a command must be in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
34551
- * * [Cloud Assistant Agent](~~64921~~) is pre-installed on the instances.
35234
+ * * [Cloud Assistant Agent](~~64921~~) must be installed on the instances.
34552
35235
  * * Before you run a PowerShell command on a Windows instance, make sure that the PowerShell module is installed on the instance.
34553
- * * When you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
35236
+ * * When you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instances meets your business requirements. For information about time zones, see [Configure the NTP service for a CentOS 6 instance](~~92803~~) or [Configure the NTP service for a Windows instance](~~51890~~).
34554
35237
  * * You can set `Timeout` to specify the timeout period for executions of the command on ECS instances. If an execution times out, Cloud Assistant Agent forcefully terminates the command process.
34555
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
34556
- * * For a scheduled task, the timeout period takes effect on each execution of the command. The timeout of one execution does not affect the subsequent executions of the command. When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
34557
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
34558
- * * Linux: 2.2.3.282.
34559
- * * Windows: 2.1.3.282.
35238
+ * * When the one-time execution of the command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
35239
+ * * For a scheduled task, the timeout period takes effect on each execution of the command. When a command execution times out, the subsequent executions of the command are not affected. When a scheduled execution of the command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
35240
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression in a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must update Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
35241
+ * - Linux: 2.2.3.282
35242
+ * - Windows: 2.1.3.282
34560
35243
  * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command execution fails, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
34561
- * * When `EnableParameter` is set to true, the custom parameter feature is enabled. When you specify `CommandContent`, you can specify custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
34562
- * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your ECS usage. You can perform operations that are described in the [View and increase resource quotas](~~184115~~) topic or call the [DescribeAccountAttribute](~~73772~~) operation to query resource quotas.
34563
- * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances, and then run the command when the value of CloudAssistantStatus in the response is true for the instances.
35244
+ * * If you set the `EnableParameter` parameter to true, the custom parameter feature is enabled. When you configure the `CommandContent` parameter, you can define custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
35245
+ * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your usage. You can perform operations that are described in the [View and increase resource quotas](~~184115~~) topic or call the [DescribeAccountAttribute](~~73772~~) operation to query resource quotas.
35246
+ * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances and run the command when the value of CloudAssistantStatus in the response is true for the instances.
34564
35247
  *
34565
35248
  * @param tmpReq RunCommandRequest
34566
35249
  * @param runtime runtime options for this request RuntimeOptions
@@ -34568,50 +35251,141 @@ export default class Client extends OpenApi {
34568
35251
  */
34569
35252
  runCommandWithOptions(tmpReq: RunCommandRequest, runtime: $Util.RuntimeOptions): Promise<RunCommandResponse>;
34570
35253
  /**
34571
- * ## Usage notes
35254
+ * ## [](#)Usage notes
34572
35255
  * Unlike the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operations, RunCommand can be used to create and run a command in a single request.
34573
35256
  * Take note of the following items:
34574
35257
  * * The instances on which you want to run a command must be in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
34575
- * * [Cloud Assistant Agent](~~64921~~) is pre-installed on the instances.
35258
+ * * [Cloud Assistant Agent](~~64921~~) must be installed on the instances.
34576
35259
  * * Before you run a PowerShell command on a Windows instance, make sure that the PowerShell module is installed on the instance.
34577
- * * When you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
35260
+ * * When you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instances meets your business requirements. For information about time zones, see [Configure the NTP service for a CentOS 6 instance](~~92803~~) or [Configure the NTP service for a Windows instance](~~51890~~).
34578
35261
  * * You can set `Timeout` to specify the timeout period for executions of the command on ECS instances. If an execution times out, Cloud Assistant Agent forcefully terminates the command process.
34579
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
34580
- * * For a scheduled task, the timeout period takes effect on each execution of the command. The timeout of one execution does not affect the subsequent executions of the command. When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
34581
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
34582
- * * Linux: 2.2.3.282.
34583
- * * Windows: 2.1.3.282.
35262
+ * * When the one-time execution of the command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
35263
+ * * For a scheduled task, the timeout period takes effect on each execution of the command. When a command execution times out, the subsequent executions of the command are not affected. When a scheduled execution of the command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
35264
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression in a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must update Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
35265
+ * - Linux: 2.2.3.282
35266
+ * - Windows: 2.1.3.282
34584
35267
  * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command execution fails, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
34585
- * * When `EnableParameter` is set to true, the custom parameter feature is enabled. When you specify `CommandContent`, you can specify custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
34586
- * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your ECS usage. You can perform operations that are described in the [View and increase resource quotas](~~184115~~) topic or call the [DescribeAccountAttribute](~~73772~~) operation to query resource quotas.
34587
- * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances, and then run the command when the value of CloudAssistantStatus in the response is true for the instances.
35268
+ * * If you set the `EnableParameter` parameter to true, the custom parameter feature is enabled. When you configure the `CommandContent` parameter, you can define custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
35269
+ * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your usage. You can perform operations that are described in the [View and increase resource quotas](~~184115~~) topic or call the [DescribeAccountAttribute](~~73772~~) operation to query resource quotas.
35270
+ * * Before you run a command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances and run the command when the value of CloudAssistantStatus in the response is true for the instances.
34588
35271
  *
34589
35272
  * @param request RunCommandRequest
34590
35273
  * @return RunCommandResponse
34591
35274
  */
34592
35275
  runCommand(request: RunCommandRequest): Promise<RunCommandResponse>;
34593
35276
  /**
34594
- * * **Preparations**:
34595
- * * The real-name verification is complete.
34596
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
34597
- * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
34598
- * * Query for available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
34599
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, create a VPC in the region where you want to create the instance. For more information, see [Create a VPC](~~65430~~).
34600
- * * **Precautions**:
34601
- * * You can create a maximum of 100 instances at a time.
34602
- * * You can use the `AutoReleaseTime` parameter to set the time when you want the instances to be automatically released.
34603
- * * After instances are created, you can call the [DescribeInstances](~~25506~~) operation to check their states.
34604
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
34605
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
34606
- * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to the new instances if you set the `InternetMaxBandwidthOut` parameter to a value greater than 0.
34607
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to bind a primary elastic network interface (ENI) to the instance. Note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned. Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI. Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is bound to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, a secondary ENI is bound to the instance.
34608
- * * After you call this operation, an error is returned if a parameter is invalid or if available resources are insufficient. For more information, see the "Error codes" section of this topic.
34609
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
34610
- * * **Best practices**:
34611
- * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of the instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
34612
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for these instances, we recommend that you specify tags for the instances by using the `Tag.N.Key` and `Tag.N.Value` parameters. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
34613
- * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify the `LaunchTemplateId` and `LaunchTemplateVersion` parameters to use the launch template.
34614
- * * When you create an instance in the [OpenAPI Explorer](https://api.alibabacloud.com/api/Ecs), you can view the best practices for calling the `RunInstances` operation. In the Preview step, click View OpenAPI in the Configurations Selected section. In the dialog box that appears, the left-side **API Workflow** section shows the operations and request parameters that are related to the `RunInstances` operation. The right-side section shows SDK examples for the **Java** and **Python** programming languages.
35277
+ * ## [](#)Usage notes
35278
+ * * **Preparations**:
35279
+ * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
35280
+ * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for selecting instance types](~~58291~~) to learn about how to select instance types.
35281
+ * * Query of available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query resources available in a specific region or zone.
35282
+ * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, [create a VPC](~~65430~~) in the region where you want to create the instance.
35283
+ * * **Comparison with CreateInstance**:
35284
+ * RunInstances has the following advantages over CreateInstance:
35285
+ * * You can call the RunInstances operation to create up to 100 instances at a time, instead of repeatedly calling the CreateInstance operation.
35286
+ * * After an instance is created, the instance enters the `Starting` state and then transitions to the `Running` state. You do not need to call the [StartInstance](~~25500~~) operation to start the instance.
35287
+ * * When you create an instance, you can specify `InternetMaxBandwidthOut` to assign a public IP address to the instance, without the need to call the [AllocatePublicIpAddress](~~25544~~) operation.
35288
+ * * You can use `AutoReleaseTime` to set the time when to automatically release the instances, without the need to call the [ModifyInstanceAutoReleaseTime](~~47576~~) operation.
35289
+ * * You can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use a launch template. This way, you do not need to configure a large number of parameters every time you create instances.
35290
+ * * You can specify `UniqueSuffix` to batch configure sequential names or hostnames for multiple instances for easy management and retrieval.
35291
+ * * When you call the RunInstances operation to create instances, you can configure the enclave-based confidential computing mode and the trusted system mode for the instances.
35292
+ * * You can set `NetworkOptions.EnableJumboFrame` to true to enable the Jumbo Frames feature when you create instances. For more information, see [MTUs](~~200512~~).
35293
+ * * **Considerations**:
35294
+ * * You can create up to 100 instances at a time.
35295
+ * * You can use `AutoReleaseTime` to set the time when to automatically release the instances.
35296
+ * * After you create instances and obtain their IDs, you can call the [DescribeInstances](~~25506~~) operation to check the status of the instances.
35297
+ * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
35298
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
35299
+ * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to new instances if you set `InternetMaxBandwidthOut` to a value greater than 0.
35300
+ * * When you call the RunInstances operation to create an instance, you can use one of the following methods to attach a primary elastic network interface (ENI) to the instance. Take note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned.
35301
+ * * Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI.
35302
+ * * Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is attached to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, the secondary ENI is attached to the instance.
35303
+ * * If a parameter is invalid or available resources are insufficient, an error is returned after you call the RunInstances operation. For more information, see the "Error codes" section of this topic.
35304
+ * * If the maximum number of instances of the specified instance type that can be created in the specified region or the maximum number of vCPUs for all instance types in a zone is exceeded, the `QuotaExceed.ElasticQuota` error is returned when you call the operation. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
35305
+ * * If the capacity of disks that belong to the specified disk category exceeds the quota limit for the specified zone, the `QuotaExceed.DiskCapacity` error is returned when you call the operation. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to view and increase the disk capacity quota.
35306
+ * * **Best practices**:
35307
+ * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different zones, different billing methods, and instance families. For more information, see [Use auto provisioning group-related API operations to batch create ECS instances](~~200772~~).
35308
+ * * You can call the `RunInstances` operation to batch create instances. To better manage and search for the instances, we recommend that you add tags to the instances by specifying `Tag.N.Key` and `Tag.N.Value`. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
35309
+ * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
35310
+ * ### [](#-1)Example 1: Create a subscription instance
35311
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type in the China (Hangzhou) region, and enable auto-renewal to renew the instance for one month on expiration. The instance uses a 40 GiB enhanced SSD (ESSD) as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35312
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35313
+ * &RegionId=cn-hangzhou
35314
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35315
+ * &InstanceType=ecs.g7.large
35316
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35317
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35318
+ * &InstanceChargeType=PrePaid
35319
+ * &SystemDisk.Size=40
35320
+ * &DataDisk.1.Size=100
35321
+ * &DataDisk.1.Category=cloud_essd
35322
+ * &SystemDisk.Category=cloud_essd
35323
+ * &Amount=1
35324
+ * &Period=1
35325
+ * &PeriodUnit=Month
35326
+ * &AutoRenew=true
35327
+ * &AutoRenewPeriod=1
35328
+ * &HostName=ECS-test
35329
+ * &Password=ECS@test1234
35330
+ * &InternetMaxBandwidthOut=10
35331
+ * &<Common request parameters>
35332
+ * ### [](#-2)Example 2: Create a pay-as-you-go instance
35333
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a pay-as-you-go instance of the ecs.g7.large instance type in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35334
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35335
+ * &RegionId=cn-hangzhou
35336
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35337
+ * &InstanceType=ecs.g7.large
35338
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35339
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35340
+ * &InstanceChargeType=PostPaid
35341
+ * &SystemDisk.Size=40
35342
+ * &DataDisk.1.Size=100
35343
+ * &DataDisk.1.Category=cloud_essd
35344
+ * &SystemDisk.Category=cloud_essd
35345
+ * &HostName=ECS-test
35346
+ * &Password=ECS@test1234
35347
+ * &InternetMaxBandwidthOut=10
35348
+ * &<Common request parameters>
35349
+ * ### [](#-3)Example 3: Create a preemptible instance
35350
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a preemptible instance of the ecs.g7.large instance type that has a 1-hour protection period in the China (Hangzhou) region. The market price of the instance type at the time of purchase is automatically used as the bidding price. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35351
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35352
+ * &RegionId=cn-hangzhou
35353
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35354
+ * &InstanceType=ecs.g7.large
35355
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35356
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35357
+ * &InstanceChargeType=PostPaid
35358
+ * &SystemDisk.Size=40
35359
+ * &DataDisk.1.Size=100
35360
+ * &DataDisk.1.Category=cloud_essd
35361
+ * &SystemDisk.Category=cloud_essd
35362
+ * &HostName=ECS-test
35363
+ * &Password=ECS@test1234
35364
+ * &InternetMaxBandwidthOut=10
35365
+ * &SpotStrategy=SpotAsPriceGo
35366
+ * &SpotDuration=1
35367
+ * &<Common request parameters>
35368
+ * ### [](#-4)Example 4: Create a subscription instance on a dedicated host
35369
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type on the dh-bp12w10wll9xcjq2\\*\\*\\*\\* dedicated host in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35370
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35371
+ * &RegionId=cn-hangzhou
35372
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35373
+ * &InstanceType=ecs.g7.large
35374
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35375
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35376
+ * &InstanceChargeType=PrePaid
35377
+ * &Amount=1
35378
+ * &Period=1
35379
+ * &PeriodUnit=Month
35380
+ * &SystemDisk.Size=40
35381
+ * &DataDisk.1.Size=100
35382
+ * &DataDisk.1.Category=cloud_essd
35383
+ * &SystemDisk.Category=cloud_essd
35384
+ * &HostName=ECS-test
35385
+ * &Password=ECS@test1234
35386
+ * &InternetMaxBandwidthOut=10
35387
+ * &DedicatedHostId=dh-bp12w10wll9xcjq2****
35388
+ * &<Common request parameters>
34615
35389
  *
34616
35390
  * @param request RunInstancesRequest
34617
35391
  * @param runtime runtime options for this request RuntimeOptions
@@ -34619,27 +35393,118 @@ export default class Client extends OpenApi {
34619
35393
  */
34620
35394
  runInstancesWithOptions(request: RunInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RunInstancesResponse>;
34621
35395
  /**
34622
- * * **Preparations**:
34623
- * * The real-name verification is complete.
34624
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
34625
- * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
34626
- * * Query for available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
34627
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, create a VPC in the region where you want to create the instance. For more information, see [Create a VPC](~~65430~~).
34628
- * * **Precautions**:
34629
- * * You can create a maximum of 100 instances at a time.
34630
- * * You can use the `AutoReleaseTime` parameter to set the time when you want the instances to be automatically released.
34631
- * * After instances are created, you can call the [DescribeInstances](~~25506~~) operation to check their states.
34632
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
34633
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
34634
- * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to the new instances if you set the `InternetMaxBandwidthOut` parameter to a value greater than 0.
34635
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to bind a primary elastic network interface (ENI) to the instance. Note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned. Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI. Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is bound to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, a secondary ENI is bound to the instance.
34636
- * * After you call this operation, an error is returned if a parameter is invalid or if available resources are insufficient. For more information, see the "Error codes" section of this topic.
34637
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
34638
- * * **Best practices**:
34639
- * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of the instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
34640
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for these instances, we recommend that you specify tags for the instances by using the `Tag.N.Key` and `Tag.N.Value` parameters. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
34641
- * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify the `LaunchTemplateId` and `LaunchTemplateVersion` parameters to use the launch template.
34642
- * * When you create an instance in the [OpenAPI Explorer](https://api.alibabacloud.com/api/Ecs), you can view the best practices for calling the `RunInstances` operation. In the Preview step, click View OpenAPI in the Configurations Selected section. In the dialog box that appears, the left-side **API Workflow** section shows the operations and request parameters that are related to the `RunInstances` operation. The right-side section shows SDK examples for the **Java** and **Python** programming languages.
35396
+ * ## [](#)Usage notes
35397
+ * * **Preparations**:
35398
+ * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
35399
+ * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for selecting instance types](~~58291~~) to learn about how to select instance types.
35400
+ * * Query of available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query resources available in a specific region or zone.
35401
+ * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, [create a VPC](~~65430~~) in the region where you want to create the instance.
35402
+ * * **Comparison with CreateInstance**:
35403
+ * RunInstances has the following advantages over CreateInstance:
35404
+ * * You can call the RunInstances operation to create up to 100 instances at a time, instead of repeatedly calling the CreateInstance operation.
35405
+ * * After an instance is created, the instance enters the `Starting` state and then transitions to the `Running` state. You do not need to call the [StartInstance](~~25500~~) operation to start the instance.
35406
+ * * When you create an instance, you can specify `InternetMaxBandwidthOut` to assign a public IP address to the instance, without the need to call the [AllocatePublicIpAddress](~~25544~~) operation.
35407
+ * * You can use `AutoReleaseTime` to set the time when to automatically release the instances, without the need to call the [ModifyInstanceAutoReleaseTime](~~47576~~) operation.
35408
+ * * You can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use a launch template. This way, you do not need to configure a large number of parameters every time you create instances.
35409
+ * * You can specify `UniqueSuffix` to batch configure sequential names or hostnames for multiple instances for easy management and retrieval.
35410
+ * * When you call the RunInstances operation to create instances, you can configure the enclave-based confidential computing mode and the trusted system mode for the instances.
35411
+ * * You can set `NetworkOptions.EnableJumboFrame` to true to enable the Jumbo Frames feature when you create instances. For more information, see [MTUs](~~200512~~).
35412
+ * * **Considerations**:
35413
+ * * You can create up to 100 instances at a time.
35414
+ * * You can use `AutoReleaseTime` to set the time when to automatically release the instances.
35415
+ * * After you create instances and obtain their IDs, you can call the [DescribeInstances](~~25506~~) operation to check the status of the instances.
35416
+ * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
35417
+ * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
35418
+ * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to new instances if you set `InternetMaxBandwidthOut` to a value greater than 0.
35419
+ * * When you call the RunInstances operation to create an instance, you can use one of the following methods to attach a primary elastic network interface (ENI) to the instance. Take note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned.
35420
+ * * Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI.
35421
+ * * Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is attached to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, the secondary ENI is attached to the instance.
35422
+ * * If a parameter is invalid or available resources are insufficient, an error is returned after you call the RunInstances operation. For more information, see the "Error codes" section of this topic.
35423
+ * * If the maximum number of instances of the specified instance type that can be created in the specified region or the maximum number of vCPUs for all instance types in a zone is exceeded, the `QuotaExceed.ElasticQuota` error is returned when you call the operation. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
35424
+ * * If the capacity of disks that belong to the specified disk category exceeds the quota limit for the specified zone, the `QuotaExceed.DiskCapacity` error is returned when you call the operation. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to view and increase the disk capacity quota.
35425
+ * * **Best practices**:
35426
+ * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different zones, different billing methods, and instance families. For more information, see [Use auto provisioning group-related API operations to batch create ECS instances](~~200772~~).
35427
+ * * You can call the `RunInstances` operation to batch create instances. To better manage and search for the instances, we recommend that you add tags to the instances by specifying `Tag.N.Key` and `Tag.N.Value`. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
35428
+ * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
35429
+ * ### [](#-1)Example 1: Create a subscription instance
35430
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type in the China (Hangzhou) region, and enable auto-renewal to renew the instance for one month on expiration. The instance uses a 40 GiB enhanced SSD (ESSD) as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35431
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35432
+ * &RegionId=cn-hangzhou
35433
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35434
+ * &InstanceType=ecs.g7.large
35435
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35436
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35437
+ * &InstanceChargeType=PrePaid
35438
+ * &SystemDisk.Size=40
35439
+ * &DataDisk.1.Size=100
35440
+ * &DataDisk.1.Category=cloud_essd
35441
+ * &SystemDisk.Category=cloud_essd
35442
+ * &Amount=1
35443
+ * &Period=1
35444
+ * &PeriodUnit=Month
35445
+ * &AutoRenew=true
35446
+ * &AutoRenewPeriod=1
35447
+ * &HostName=ECS-test
35448
+ * &Password=ECS@test1234
35449
+ * &InternetMaxBandwidthOut=10
35450
+ * &<Common request parameters>
35451
+ * ### [](#-2)Example 2: Create a pay-as-you-go instance
35452
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a pay-as-you-go instance of the ecs.g7.large instance type in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35453
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35454
+ * &RegionId=cn-hangzhou
35455
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35456
+ * &InstanceType=ecs.g7.large
35457
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35458
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35459
+ * &InstanceChargeType=PostPaid
35460
+ * &SystemDisk.Size=40
35461
+ * &DataDisk.1.Size=100
35462
+ * &DataDisk.1.Category=cloud_essd
35463
+ * &SystemDisk.Category=cloud_essd
35464
+ * &HostName=ECS-test
35465
+ * &Password=ECS@test1234
35466
+ * &InternetMaxBandwidthOut=10
35467
+ * &<Common request parameters>
35468
+ * ### [](#-3)Example 3: Create a preemptible instance
35469
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a preemptible instance of the ecs.g7.large instance type that has a 1-hour protection period in the China (Hangzhou) region. The market price of the instance type at the time of purchase is automatically used as the bidding price. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35470
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35471
+ * &RegionId=cn-hangzhou
35472
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35473
+ * &InstanceType=ecs.g7.large
35474
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35475
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35476
+ * &InstanceChargeType=PostPaid
35477
+ * &SystemDisk.Size=40
35478
+ * &DataDisk.1.Size=100
35479
+ * &DataDisk.1.Category=cloud_essd
35480
+ * &SystemDisk.Category=cloud_essd
35481
+ * &HostName=ECS-test
35482
+ * &Password=ECS@test1234
35483
+ * &InternetMaxBandwidthOut=10
35484
+ * &SpotStrategy=SpotAsPriceGo
35485
+ * &SpotDuration=1
35486
+ * &<Common request parameters>
35487
+ * ### [](#-4)Example 4: Create a subscription instance on a dedicated host
35488
+ * Use the aliyun\\_3\\_x64\\_20G_alibase\\_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type on the dh-bp12w10wll9xcjq2\\*\\*\\*\\* dedicated host in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
35489
+ * http(s)://ecs.aliyuncs.com/?Action=RunInstances
35490
+ * &RegionId=cn-hangzhou
35491
+ * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
35492
+ * &InstanceType=ecs.g7.large
35493
+ * &SecurityGroupId=sg-bp150uqocpf9jj70****
35494
+ * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
35495
+ * &InstanceChargeType=PrePaid
35496
+ * &Amount=1
35497
+ * &Period=1
35498
+ * &PeriodUnit=Month
35499
+ * &SystemDisk.Size=40
35500
+ * &DataDisk.1.Size=100
35501
+ * &DataDisk.1.Category=cloud_essd
35502
+ * &SystemDisk.Category=cloud_essd
35503
+ * &HostName=ECS-test
35504
+ * &Password=ECS@test1234
35505
+ * &InternetMaxBandwidthOut=10
35506
+ * &DedicatedHostId=dh-bp12w10wll9xcjq2****
35507
+ * &<Common request parameters>
34643
35508
  *
34644
35509
  * @param request RunInstancesRequest
34645
35510
  * @return RunInstancesResponse
@@ -34745,16 +35610,16 @@ export default class Client extends OpenApi {
34745
35610
  */
34746
35611
  startInstances(request: StartInstancesRequest): Promise<StartInstancesResponse>;
34747
35612
  /**
34748
- * The session management feature is in public preview. To use this feature, log on to the ECS console with your Alibaba Cloud account and enable this feature.
35613
+ * ## [](#)Usage notes
34749
35614
  * When you use custom code to connect to an ECS instance that serves as a client, you can call this operation to obtain the WebSocket URL that is used to connect to the instance. Take note of the following items:
34750
- * * The ECS instance must be in the Running (Running) state.
35615
+ * * The ECS instance must be in the Running state.
34751
35616
  * * Cloud Assistant Agent must be installed on the ECS instance. You can call the [DescribeCloudAssistantStatus](~~87346~~) operation to check whether Cloud Assistant Agent is installed on the ECS instance and query the version number of the installed Cloud Assistant Agent.
34752
35617
  * * If Cloud Assistant Agent is not installed on the ECS instance, call the [InstallCloudAssistant](~~85916~~) operation to install Cloud Assistant Agent.
34753
- * * Only the Cloud Assistant Agent versions that are later than the following ones support the session management feature. You can upgrade Cloud Assistant Agent. For information about how to upgrade Cloud Assistant Agent, see [Update or disable updates for Cloud Assistant Agent](~~134383~~).
34754
- * * For Linux operating systems: 2.2.3.256
34755
- * * For Windows operating systems: 2.1.3.256
35618
+ * * The Cloud Assistant Agent versions that are later than the following ones support the session management feature. If you need to upgrade the Cloud Assistant Agent version, follow the instructions in [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
35619
+ * * Linux operating system: 2.2.3.256
35620
+ * * Windows operating system: 2.1.3.256
34756
35621
  * * Each WebSocket URL returned by the StartTerminalSession operation remains valid for 10 minutes.
34757
- * * Up to 1,000 sessions can be created and available per region. Each ECS instance can have up to 10 sessions in the connected state.
35622
+ * * Up to 1,000 sessions can be created and available in a region. Each ECS instance can have up to 20 sessions in the connected state.
34758
35623
  *
34759
35624
  * @param request StartTerminalSessionRequest
34760
35625
  * @param runtime runtime options for this request RuntimeOptions
@@ -34762,16 +35627,16 @@ export default class Client extends OpenApi {
34762
35627
  */
34763
35628
  startTerminalSessionWithOptions(request: StartTerminalSessionRequest, runtime: $Util.RuntimeOptions): Promise<StartTerminalSessionResponse>;
34764
35629
  /**
34765
- * The session management feature is in public preview. To use this feature, log on to the ECS console with your Alibaba Cloud account and enable this feature.
35630
+ * ## [](#)Usage notes
34766
35631
  * When you use custom code to connect to an ECS instance that serves as a client, you can call this operation to obtain the WebSocket URL that is used to connect to the instance. Take note of the following items:
34767
- * * The ECS instance must be in the Running (Running) state.
35632
+ * * The ECS instance must be in the Running state.
34768
35633
  * * Cloud Assistant Agent must be installed on the ECS instance. You can call the [DescribeCloudAssistantStatus](~~87346~~) operation to check whether Cloud Assistant Agent is installed on the ECS instance and query the version number of the installed Cloud Assistant Agent.
34769
35634
  * * If Cloud Assistant Agent is not installed on the ECS instance, call the [InstallCloudAssistant](~~85916~~) operation to install Cloud Assistant Agent.
34770
- * * Only the Cloud Assistant Agent versions that are later than the following ones support the session management feature. You can upgrade Cloud Assistant Agent. For information about how to upgrade Cloud Assistant Agent, see [Update or disable updates for Cloud Assistant Agent](~~134383~~).
34771
- * * For Linux operating systems: 2.2.3.256
34772
- * * For Windows operating systems: 2.1.3.256
35635
+ * * The Cloud Assistant Agent versions that are later than the following ones support the session management feature. If you need to upgrade the Cloud Assistant Agent version, follow the instructions in [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
35636
+ * * Linux operating system: 2.2.3.256
35637
+ * * Windows operating system: 2.1.3.256
34773
35638
  * * Each WebSocket URL returned by the StartTerminalSession operation remains valid for 10 minutes.
34774
- * * Up to 1,000 sessions can be created and available per region. Each ECS instance can have up to 10 sessions in the connected state.
35639
+ * * Up to 1,000 sessions can be created and available in a region. Each ECS instance can have up to 20 sessions in the connected state.
34775
35640
  *
34776
35641
  * @param request StartTerminalSessionRequest
34777
35642
  * @return StartTerminalSessionResponse