文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `CreateScheduleGroup` 搭配 AWS SDK 使用
下列程式碼範例示範如何使用 `CreateScheduleGroup`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [排程事件](scheduler_example_scheduler_ScheduledEventsScenario_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/EventBridge Scheduler#code-examples)中設定和執行。
```
///
/// Creates a new schedule group in Amazon EventBridge Scheduler.
///
/// The name of the schedule group.
/// True if the schedule group was created successfully, false otherwise.
public async Task CreateScheduleGroupAsync(string name)
{
try
{
var request = new CreateScheduleGroupRequest { Name = name };
var response = await _amazonScheduler.CreateScheduleGroupAsync(request);
Console.WriteLine($"Successfully created schedule group '{name}': {response.ScheduleGroupArn}.");
return true;
}
catch (ConflictException ex)
{
// If the name is not unique, a ConflictException will be thrown.
_logger.LogError($"Failed to create schedule group '{name}' due to a conflict. {ex.Message}");
return false;
}
catch (Exception ex)
{
_logger.LogError(
$"An error occurred while creating schedule group '{name}': {ex.Message}");
return false;
}
}
```
+ 如需 API 詳細資訊，請參閱《*適用於 .NET 的 AWS SDK API 參考*》中的 [CreateScheduleGroup](https://docs.aws.amazon.com/goto/DotNetSDKV3/scheduler-2021-06-30/CreateScheduleGroup)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/scheduler#code-examples)中設定和執行。
```
/**
* Creates a new schedule group.
*
* @param name the name of the schedule group to be created
* @return a {@link CompletableFuture} representing the asynchronous operation of creating the schedule group
*/
public CompletableFuture createScheduleGroup(String name) {
CreateScheduleGroupRequest request = CreateScheduleGroupRequest.builder()
.name(name)
.build();
logger.info("Initiating createScheduleGroup call for group: {}", name);
CompletableFuture futureResponse = getAsyncClient().createScheduleGroup(request);
futureResponse.whenComplete((response, ex) -> {
if (ex != null) {
if (ex instanceof CompletionException && ex.getCause() instanceof ConflictException) {
// Rethrow the ConflictException
throw (ConflictException) ex.getCause();
} else {
throw new CompletionException("Failed to create schedule group: " + name, ex);
}
} else if (response == null) {
throw new RuntimeException("Failed to create schedule group: response was null");
} else {
logger.info("Successfully created schedule group '{}': {}", name, response.scheduleGroupArn());
}
});
return futureResponse;
}
```
+ 如需 API 詳細資訊，請參閱《*AWS SDK for Java 2.x API 參考*》中的 [CreateScheduleGroup](https://docs.aws.amazon.com/goto/SdkForJavaV2/scheduler-2021-06-30/CreateScheduleGroup)。
------
#### [ Python ]
**適用於 Python 的 SDK (Boto3)**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/scheduler#code-examples)中設定和執行。
```
class SchedulerWrapper:
def __init__(self, eventbridge_scheduler_client: client):
self.scheduler_client = eventbridge_scheduler_client
@classmethod
def from_client(cls) -> "SchedulerWrapper":
"""
Creates a SchedulerWrapper instance with a default EventBridge Scheduler client.
:return: An instance of SchedulerWrapper initialized with the default EventBridge Scheduler client.
"""
eventbridge_scheduler_client = boto3.client("scheduler")
return cls(eventbridge_scheduler_client)
def create_schedule_group(self, name: str) -> str:
"""
Creates a new schedule group with the specified name and description.
:param name: The name of the schedule group.
:param description: The description of the schedule group.
:return: The ARN of the created schedule group.
"""
try:
response = self.scheduler_client.create_schedule_group(Name=name)
return response["ScheduleGroupArn"]
except ClientError as err:
if err.response["Error"]["Code"] == "ConflictException":
logger.error(
"Failed to create schedule group '%s' due to a conflict. %s",
name,
err.response["Error"]["Message"],
)
else:
logger.error(
"Error creating schedule group: %s",
err.response["Error"]["Message"],
)
raise
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Python (Boto3) API 參考》**中的 [CreateScheduleGroup](https://docs.aws.amazon.com/goto/boto3/scheduler-2021-06-30/CreateScheduleGroup)。
------
#### [ SAP ABAP ]
**適用於 SAP ABAP 的開發套件**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/scd#code-examples)中設定和執行。
```
TRY.
" Example iv_name = 'my-schedule-group'
DATA(lo_result) = lo_scd->createschedulegroup(
iv_name = iv_name ).
ov_schedule_group_arn = lo_result->get_schedulegrouparn( ).
MESSAGE 'Schedule group created successfully.' TYPE 'I'.
CATCH /aws1/cx_scdconflictexception INTO DATA(lo_conflict_ex).
DATA(lv_error) = |Conflict creating schedule group: { lo_conflict_ex->if_message~get_text( ) }|.
MESSAGE lv_error TYPE 'I'.
CATCH /aws1/cx_rt_generic INTO DATA(lo_generic_ex).
DATA(lv_generic_error) = |Error creating schedule group: { lo_generic_ex->if_message~get_text( ) }|.
MESSAGE lv_generic_error TYPE 'I'.
ENDTRY.
```
+ 如需 API 詳細資訊，請參閱《適用於 *AWS SAP ABAP 的 SDK API 參考*》中的 [CreateScheduleGroup](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。
------