기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateDataSource
데이터 원본을 생성합니다.
요청 구문
POST /accounts/AwsAccountId/data-sources HTTP/1.1
Content-type: application/json
{
"Credentials": {
"CopySourceArn": "string",
"CredentialPair": {
"AlternateDataSourceParameters": [
{
"AmazonElasticsearchParameters": {
"Domain": "string"
},
"AmazonOpenSearchParameters": {
"Domain": "string"
},
"AthenaParameters": {
"WorkGroup": "string"
},
"AuroraParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"AuroraPostgreSqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"AwsIotAnalyticsParameters": {
"DataSetName": "string"
},
"ExasolParameters": {
"Host": "string",
"Port": number
},
"JiraParameters": {
"SiteBaseUrl": "string"
},
"MariaDbParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"MySqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"OracleParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"PostgreSqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"PrestoParameters": {
"Catalog": "string",
"Host": "string",
"Port": number
},
"RdsParameters": {
"Database": "string",
"InstanceId": "string"
},
"RedshiftParameters": {
"ClusterId": "string",
"Database": "string",
"Host": "string",
"Port": number
},
"S3Parameters": {
"ManifestFileLocation": {
"Bucket": "string",
"Key": "string"
}
},
"ServiceNowParameters": {
"SiteBaseUrl": "string"
},
"SnowflakeParameters": {
"Database": "string",
"Host": "string",
"Warehouse": "string"
},
"SparkParameters": {
"Host": "string",
"Port": number
},
"SqlServerParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"TeradataParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"TwitterParameters": {
"MaxRows": number,
"Query": "string"
}
}
],
"Password": "string",
"Username": "string"
}
},
"DataSourceId": "string",
"DataSourceParameters": {
"AmazonElasticsearchParameters": {
"Domain": "string"
},
"AmazonOpenSearchParameters": {
"Domain": "string"
},
"AthenaParameters": {
"WorkGroup": "string"
},
"AuroraParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"AuroraPostgreSqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"AwsIotAnalyticsParameters": {
"DataSetName": "string"
},
"ExasolParameters": {
"Host": "string",
"Port": number
},
"JiraParameters": {
"SiteBaseUrl": "string"
},
"MariaDbParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"MySqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"OracleParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"PostgreSqlParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"PrestoParameters": {
"Catalog": "string",
"Host": "string",
"Port": number
},
"RdsParameters": {
"Database": "string",
"InstanceId": "string"
},
"RedshiftParameters": {
"ClusterId": "string",
"Database": "string",
"Host": "string",
"Port": number
},
"S3Parameters": {
"ManifestFileLocation": {
"Bucket": "string",
"Key": "string"
}
},
"ServiceNowParameters": {
"SiteBaseUrl": "string"
},
"SnowflakeParameters": {
"Database": "string",
"Host": "string",
"Warehouse": "string"
},
"SparkParameters": {
"Host": "string",
"Port": number
},
"SqlServerParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"TeradataParameters": {
"Database": "string",
"Host": "string",
"Port": number
},
"TwitterParameters": {
"MaxRows": number,
"Query": "string"
}
},
"Name": "string",
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"SslProperties": {
"DisableSsl": boolean
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"Type": "string",
"VpcConnectionProperties": {
"VpcConnectionArn": "string"
}
}URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- AwsAccountId
-
AWS 계정 ID입니다.
길이 제약 조건: 고정 길이는 12입니다.
패턴:
^[0-9]{12}$필수 사항: 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- DataSourceId
-
데이터 원본의 ID입니다. 이 ID는 다음에 대해 고유합니다AWS 리전FororAWS계정.
Type: 문자열
필수 사항: 예
- Name
-
데이터 원본의 표시 이름입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이 128.
필수 사항: 예
- Type
-
데이터 소스의 유형입니다. 모든 데이터 원본의 목록을 반환하려면
ListDataSources.사용
AMAZON_ELASTICSEARCH부터 Amazon OpenSearch 서비스.Type: 문자열
유효한 값:
ADOBE_ANALYTICS | AMAZON_ELASTICSEARCH | ATHENA | AURORA | AURORA_POSTGRESQL | AWS_IOT_ANALYTICS | GITHUB | JIRA | MARIADB | MYSQL | ORACLE | POSTGRESQL | PRESTO | REDSHIFT | S3 | SALESFORCE | SERVICENOW | SNOWFLAKE | SPARK | SQLSERVER | TERADATA | TWITTER | TIMESTREAM | AMAZON_OPENSEARCH | EXASOL필수 사항: 예
- Credentials
-
자격 증명 아마존 QuickSight 를 기본 소스에 연결하는 데 사용되는 파라미터입니다. 현재는 사용자 이름과 암호를 기반으로 하는 자격 증명만 지원됩니다.
유형: DataSourceCredentials 객체
필수 사항: 아니요
- DataSourceParameters
-
아마존의 매개 변수 QuickSight 를 기본 소스에 연결하는 데 사용되는 파라미터입니다.
유형: DataSourceParameters 객체
필수 사항: 아니요
- Permissions
-
데이터 원본에 대한 리소스 권한 목록.
Type: 배열ResourcePermission사물
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 64개입니다.
필수 사항: 아니요
- SslProperties
-
Amazon QuickSight 기본 소스에 연결합니다.
유형: SslProperties 객체
필수 사항: 아니요
- Tags
-
데이터 소스에 할당된 리소스 태그에 대한 키-값 쌍의 맵을 포함합니다.
Type: 배열Tag사물
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.
필수 사항: 아니요
- VpcConnectionProperties
-
Amazon을 원하는 경우에만 이 파라미터를 사용합니다. QuickSight 기본 소스에 연결할 때 VPC 연결을 사용합니다.
유형: VpcConnectionProperties 객체
필수 사항: 아니요
응답 구문
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"CreationStatus": "string",
"DataSourceId": "string",
"RequestId": "string"
}응답 요소
작업이 성공하면 서비스가 다음 HTTP 응답을 다시 전송합니다.
- Status
-
요청의 HTTP 상태입니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- Arn
-
데이터 원본의 Amazon 리소스 이름(ARN)입니다.
Type: 문자열
- CreationStatus
-
데이터 소스 생성 상태입니다.
Type: 문자열
유효한 값:
CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED - DataSourceId
-
데이터 원본의 ID입니다. 이 ID는 For EachAWS 리전FororAWS계정.
Type: 문자열
- RequestId
-
이AWS작업에 대한 요청 ID입니다.
Type: 문자열
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- AccessDeniedException
-
이 항목에 액세스할 수 없습니다. 제공된 자격 증명을 검증할 수 없습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 정책에 올바른 권한이 있고 올바른 액세스 키를 사용하고 있는지 여부.
HTTP 상태 코드: 401
- ConflictException
-
리소스를 업데이트하거나 삭제하면 일관성 없는 상태가 발생할 수 있습니다.
HTTP 상태 코드: 409
- InternalFailureException
-
내부 실패가 발생했습니다.
HTTP 상태 코드: 500
- InvalidParameterValueException
-
하나 이상의 매개변수에 유효하지 않은 값이 있습니다.
HTTP 상태 코드: 400
- LimitExceededException
-
한도를 초과했습니다.
HTTP 상태 코드: 409
- ResourceExistsException
-
지정한 리소스가 이미 존재합니다.
HTTP 상태 코드: 409
- ResourceNotFoundException
-
리소스를 하나 이상 찾을 수 없습니다.
HTTP 상태 코드: 404
- ThrottlingException
-
액세스가 제한되었습니다.
HTTP 상태 코드: 429
예
예
이 예는 의 한 가지 사용법을 보여줍니다. CreateDataSource.
예제 요청
POST /accounts/{AwsAccountId}/data-sources HTTP/1.1 Content-type: application/json
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
