기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 생산성을 위한 AppFabric API 작업(미리 보기) | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 생산성을 위한 AppFabric 기능에는 다음 작업이 지원됩니다. 다른 모든 AppFabric API 작업에 대해서는 [AWS AppFabric API 작업](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html)을 참조하세요. **Topics** + [인증](API_Authorize.md) + [CreateAppClient](API_CreateAppClient.md) + [DeleteAppClient](API_DeleteAppClient.md) + [GetAppClient](API_GetAppClient.md) + [ListActionableInsights](API_ListActionableInsights.md) + [ListAppClients](API_ListAppClients.md) + [ListMeetingInsights](API_ListMeetingInsights.md) + [PutFeedback](API_PutFeedback.md) + [토큰](API_Token.md) + [UpdateAppClient](API_UpdateAppClient.md) # 인증 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 인증합니다. **Topics** + [요청 본문](#API_Authorize_request) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **app\$1client\$1id** | 인증할 AppClient의 ID입니다. | | **redirect\$1uri** | 인증 후 최종 사용자를 리디렉션할 URI입니다. | | **state** | 요청과 콜백 사이의 상태를 유지하기 위한 고유 값입니다. | # CreateAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 생성합니다. **Topics** + [요청 본문](#API_CreateAppClient_request) + [응답 요소](#API_CreateAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appName** | 앱의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255입니다. 필수 항목 여부: 예 | | **clientToken** | 요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자를 지정합니다. 이렇게 하면 실수로 같은 작업을 두 번 수행하지 않고 요청을 안전하게 재시도할 수 있습니다. 나중에 작업을 호출할 때 동일한 값을 전달하려면 다른 모든 파라미터에도 동일한 값을 전달해야 합니다. [UUID 유형의 값](https://wikipedia.org/wiki/Universally_unique_identifier)을 사용하는 것이 좋습니다. 이 값을 제공하지 않으면가 임의의 값을 AWS 생성합니다. 다른 파라미터를 사용하여 `ClientToken`과 같은 작업을 재시도하면 `IdempotentParameterMismatch` 오류가 발생하며 재시도가 실패합니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 아니요 | | **customerManagedKeyIdentifier** | 에서 고객 관리형 키 생성된의 ARN입니다 AWS Key Management Service. 키는 데이터 암호화에 사용합니다. 키가 지정되지 않은 경우 AWS 관리형 키 가 사용됩니다. 리소스에 할당할 태그의 키-값 페어 맵입니다. AWS 소유 키 및 고객 관리형 키에 대한 자세한 내용은 *AWS Key Management Service 개발자 안내서*의 [고객 키 및 AWS 키를](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 항목 여부: 아니요 | | **description** | 앱에 대한 설명입니다. 유형: 문자열 필수 항목 여부: 예 | | **iconUrl** | AppClient의 아이콘 또는 로고 URL입니다. 유형: 문자열 필수 항목 여부: 아니요 | | **redirectUrls** | 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 5개. 길이 제약: 최소 길이 1. 최대 길이는 2,048. 패턴: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 필수 여부: 예 | | **starterUserEmails** | AppClient가 확인될 때까지 인사이트를 받을 수 있도록 액세스가 허용된 사용자의 스타터 이메일 주소입니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제한: 최소 길이는 0. 최대 길이는 320입니다. 패턴: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 필수 여부: 예 | | **tags** | 리소스에 할당할 태그의 키-값 페어 맵입니다. 유형: 태그 객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClientSummary** | AppClient의 요약을 포함합니다. 유형: [AppClientSummary](API_AppClientSummary.md) 객체 | # DeleteAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 애플리케이션 클라이언트를 삭제합니다. **Topics** + [요청 본문](#API_DeleteAppClient_request) + [응답 요소](#API_DeleteAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | ## 응답 요소 액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다. # GetAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient에 대한 정보를 반환합니다. **Topics** + [요청 본문](#API_GetAppClient_request) + [응답 요소](#API_GetAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClient** | AppClient에 대한 정보가 들어 있습니다. 유형: [AppClient](API_AppClient.md) 객체 | # ListActionableInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 가장 중요한 실행 가능 이메일 메시지, 작업 및 기타 업데이트를 나열합니다. **Topics** + [요청 본문](#API_ListActionableInsights_request) + [응답 요소](#API_ListActionableInsights_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **ActionableInsightsList** | 제목, 설명, 작업, 생성된 타임스탬프 등 실행 가능한 인사이트를 나열합니다. 자세한 내용은 [ActionableInsights](API_ActionableInsights.md) 단원을 참조하십시오. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # ListAppClients | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 모든 AppClient의 목록을 반환합니다. **Topics** + [요청 본문](#API_ListAppClients_request) + [응답 요소](#API_ListAppClients_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **maxResults** | 호출 한 개당 반환되는 결과의 최대 수입니다. `nextToken`을 사용하여 추가 결과 페이지를 얻을 수 있습니다. 이는 상한선일 뿐입니다. 호출당 반환되는 실제 결과 수는 지정된 최대값보다 적을 수 있습니다. 유효 범위: 최소값 1. 최댓값은 100입니다. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClientList** | AppClient 결과 목록을 포함합니다. 유형: [AppClientSummary](API_AppClientSummary.md) 객체의 배열 | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # ListMeetingInsights | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 가장 중요한 실행 가능 캘린더 이벤트를 나열합니다. **Topics** + [요청 본문](#API_ListMeetingInsights_request) + [응답 요소](#API_ListMeetingInsights_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. | ## 응답 요소 작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **MeetingInsightList** | 실행 가능한 회의 인사이트를 나열합니다. 자세한 내용은 [MeetingInsights](API_MeetingInsights.md) 단원을 참조하십시오. | | **nextToken** | `nextToken`이 반환되는 경우 더 많은 결과를 사용할 수 있습니다. `nextToken`의 값은 각 페이지의 고유한 페이지 매김 토큰입니다. 반환된 토큰을 사용하여 다시 호출하여 다음 페이지를 검색합니다. 다른 모든 인수는 변경하지 않고 유지합니다. 각 페이지 매김 토큰은 24시간 후 만료됩니다. 만료된 페이지 매김 토큰을 사용하면 HTTP 400 InvalidToken 오류가 반환됩니다. 유형: 문자열 | # PutFeedback | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 사용자가 주어진 인사이트나 작업에 대한 피드백을 제출할 수 있습니다. **Topics** + [요청 본문](#API_PutFeedback_request) + [응답 요소](#API_PutFeedback_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **id** | 피드백을 제출받는 객체의 ID입니다. 이는 InsightId 또는 ActionId일 수 있습니다. | | **feedbackFor** | 피드백을 받는 인사이트 유형입니다. 가능한 값: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` | | **feedbackRating** | 피드백 평점: `1`\$1`5` 평점이 높을수록 좋습니다. | ## 응답 요소 작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다. # 토큰 | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient가 인증 코드를 액세스 토큰으로 교환할 수 있도록 허용하는 정보를 포함합니다. **Topics** + [요청 본문](#API_Token_request) + [응답 요소](#API_Token_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **code** | 인증 엔드포인트에서 받은 인증 코드입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 | | **grant\$1type** | 토큰의 권한 부여 유형입니다. `authorization_code` 또는 `refresh_token`여야 합니다. 유형: 문자열 필수 항목 여부: 예 | | **app\$1client\$1id** | AppClient의 ID입니다. 유형: String 패턴: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | | **redirect\$1uri** | 권한 부여 엔드포인트에 전달된 리디렉션 URI입니다. 유형: 문자열 필수 항목 여부: 아니요 | | **refresh\$1token** | 초기 토큰 요청에서 받은 새로 고침 토큰입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 4096. 필수 여부: 아니요 | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appfabric\$1user\$1id** | 토큰 사용자의 ID입니다. `authorization_code` 권한 부여 유형을 사용하는 요청의 경우에만 반환됩니다. 유형: 문자열 | | **expires\$1in** | 토큰큰이 만료될 때까지의 시간(초)입니다. 타입: Long | | **refresh\$1token** | 후속 요청에 사용할 새로 고침 토큰입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. | | **token** | 액세스 토큰 입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. | | **token\$1type** | 토큰 유형입니다. 유형: 문자열 | # UpdateAppClient | | | --- | | 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | AppClient를 업데이트합니다. **Topics** + [요청 본문](#API_UpdateAppClient_request) + [응답 요소](#API_UpdateAppClient_response) ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. | 파라미터 | 설명 | | --- | --- | | **appClientIdentifier** | 요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(UUID)입니다. 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 필수 여부: 예 | | **redirectUrls** | 인증 후 최종 사용자를 리디렉션할 URI입니다. redirectUrl을 최대 5개 추가할 수 있습니다. 예를 들어 `https://localhost:8080`입니다. 타입: 문자열 배열 배열 구성원: 최소수는 1개입니다. 최대 항목 수는 5개. 길이 제약: 최소 길이 1. 최대 길이는 2,048. 패턴: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` | ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. | 파라미터 | 설명 | | --- | --- | | **appClient** | AppClient에 대한 정보가 들어 있습니다. 유형: [AppClient](API_AppClient.md) 객체 |