Stage
- 인쇄
- PDF
Stage
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Usage Plan 연결
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/associate-usage-plan
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
{
"usagePlanId" : "usagePlanId"
}
응답 코드
- 204
응답 바디
- 없음
Stage 생성
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
요청 바디
{
"cacheTtlSec" : 0,
"ipAclList" : "ipAclList",
"stageName" : "stageName",
"throttleRps" : 6,
"response" : "response",
"deploymentDescription" : "deploymentDescription",
"isMaintenance" : true,
"enabledContentEncoding": true,
"minimumCompressionSize": 0,
"ipAclCode" : "ALLOWED",
"endpointDomain" : "endpointDomain",
"statusCode" : 1
}
응답 코드
- 201
응답 바디
{
"stage" : {
"canaryDeployedTime" : "2000-01-23T04:56:07.000+00:00",
"modifier" : "modifier",
"canaryEndpointDomain" : "canaryEndpointDomain",
"canaryThrottleRps" : 5,
"cacheTtlSec" : 0,
"stageName" : "stageName",
"throttleRps" : 4,
"monthQuotaRequest" : 9,
"canaryCacheTtlSec" : 6,
"canaryDistributionRate" : 5.962134,
"apiId" : "apiId",
"stageId" : "stageId",
"deployedStageDeploymentNo" : 7,
"useDistributionRate" : true,
"canaryDeploymentDescription" : "canaryDeploymentDescription",
"dayQuotaRequest" : 2,
"isMaintenance" : true,
"rateRps" : 3,
"endpointDomain" : "endpointDomain",
"ipAclList" : "ipAclList",
"canaryDeploymentNo" : 1,
"regTime" : "2000-01-23T04:56:07.000+00:00",
"response" : "response",
"canaryConditions" : [ {
"parameterName" : "parameterName",
"parameterCode" : "REQUEST_HEADER",
"parameterValue" : "parameterValue"
} ],
"tenantId" : "tenantId",
"ipAclCode" : "ALLOWED",
"statusCode" : 2,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
}
Stage 삭제
URL
DELETE https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
- 없음
응답 코드
- 204
응답 바디
- 없음
Stage 배포
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/deploy
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
{
"deploymentNo" : 0
}
응답 코드
- 200
응답 바디
{
"stage" : {
"canaryDeployedTime" : "2000-01-23T04:56:07.000+00:00",
"modifier" : "modifier",
"canaryEndpointDomain" : "canaryEndpointDomain",
"canaryThrottleRps" : 5,
"cacheTtlSec" : 0,
"stageName" : "stageName",
"throttleRps" : 4,
"monthQuotaRequest" : 9,
"canaryCacheTtlSec" : 6,
"canaryDistributionRate" : 5.962134,
"apiId" : "apiId",
"stageId" : "stageId",
"deployedStageDeploymentNo" : 7,
"useDistributionRate" : true,
"canaryDeploymentDescription" : "canaryDeploymentDescription",
"dayQuotaRequest" : 2,
"isMaintenance" : true,
"rateRps" : 3,
"endpointDomain" : "endpointDomain",
"ipAclList" : "ipAclList",
"canaryDeploymentNo" : 1,
"regTime" : "2000-01-23T04:56:07.000+00:00",
"response" : "response",
"canaryConditions" : [ {
"parameterName" : "parameterName",
"parameterCode" : "REQUEST_HEADER",
"parameterValue" : "parameterValue"
} ],
"tenantId" : "tenantId",
"ipAclCode" : "ALLOWED",
"statusCode" : 2,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
}
Usage Plan 연결삭제
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/disassociate-usage-plan
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
{
"usagePlanId" : "usagePlanId"
}
응답 코드
- 204
응답 바디
- 없음
연결할 Usage Plan 조회
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/search
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
요청 바디
{
"usagePlanId" : "usagePlanId"
}
응답 코드
- 200
응답 바디
{
"stages" : [ {
"stageName" : "stageName",
"stageId" : "stageId"
} ]
}
Stage 검색
URL
GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
- 없음
응답 코드
- 200
응답 바디
{
"stage" : {
"canaryDeployedTime" : "2000-01-23T04:56:07.000+00:00",
"modifier" : "modifier",
"canaryEndpointDomain" : "canaryEndpointDomain",
"canaryThrottleRps" : 5,
"cacheTtlSec" : 0,
"stageName" : "stageName",
"throttleRps" : 4,
"monthQuotaRequest" : 9,
"canaryCacheTtlSec" : 6,
"canaryDistributionRate" : 5.962134,
"apiId" : "apiId",
"stageId" : "stageId",
"deployedStageDeploymentNo" : 7,
"useDistributionRate" : true,
"canaryDeploymentDescription" : "canaryDeploymentDescription",
"dayQuotaRequest" : 2,
"isMaintenance" : true,
"rateRps" : 3,
"endpointDomain" : "endpointDomain",
"ipAclList" : "ipAclList",
"canaryDeploymentNo" : 1,
"regTime" : "2000-01-23T04:56:07.000+00:00",
"response" : "response",
"canaryConditions" : [ {
"parameterName" : "parameterName",
"parameterCode" : "REQUEST_HEADER",
"parameterValue" : "parameterValue"
} ],
"tenantId" : "tenantId",
"ipAclCode" : "ALLOWED",
"statusCode" : 2,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
}
Stage 조회
URL
GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
요청 바디
- 없음
응답 코드
- 200
응답 바디
{
"host" : "host",
"stages" : [ {
"canaryDeploymentNo" : 0,
"stageName" : "stageName",
"isCanary" : true,
"resourceDtos" : [ {
"corsMaxAge" : "corsMaxAge",
"resourceId" : "resourceId",
"corsAllowMethods" : "corsAllowMethods",
"methods" : [ {
"methodName" : "ANY",
"methodCode" : "methodCode"
} ],
"corsAllowOrigin" : "corsAllowOrigin",
"resourcePath" : "resourcePath",
"corsAllowCredentials" : "corsAllowCredentials",
"corsExposeHeaders" : "corsExposeHeaders",
"apiId" : "apiId",
"corsAllowHeaders" : "corsAllowHeaders"
} ],
"defaultDeploymentNo" : 6,
"stageId" : "stageId"
} ]
}
Stage 조회
URL
GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/filter
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
요청 바디
- 없음
응답 코드
- 200
응답 바디
{
"host" : "host",
"stages" : [ {
"canaryDeploymentNo" : 0,
"stageName" : "stageName",
"isCanary" : true,
"resourceDtos" : [ {
"corsMaxAge" : "corsMaxAge",
"resourceId" : "resourceId",
"corsAllowMethods" : "corsAllowMethods",
"methods" : [ {
"methodName" : "ANY",
"methodCode" : "methodCode"
} ],
"corsAllowOrigin" : "corsAllowOrigin",
"resourcePath" : "resourcePath",
"corsAllowCredentials" : "corsAllowCredentials",
"corsExposeHeaders" : "corsExposeHeaders",
"apiId" : "apiId",
"corsAllowHeaders" : "corsAllowHeaders"
} ],
"defaultDeploymentNo" : 6,
"stageId" : "stageId"
} ]
}
캐시 초기화
URL
POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/cache-initialize
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
- 없음
응답 코드
- 200
응답 바디
- 없음
Stage에 연결된 Usage Plan 검색
URL
GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/usage-plans
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
offset | query string | N | Long | Offset 최소: 0 최대: 9,223,372,036,854,775,807 |
limit | query string | N | Long | Limit 최소: 1 최대: 9,223,372,036,854,775,807 |
usagePlanName | query string | N | String | Usage Plan Name 길이(최대/최소): 0/20 |
요청 바디
- 없음
응답 코드
- 200
응답 바디
{
"total" : 5,
"monthQuotaRequest" : 6,
"dayQuotaRequest" : 0,
"rateRps" : 1,
"quotaCondition" : "quotaCondition",
"content" : [ {
"domainCode" : "domainCode",
"usagePlanId" : "usagePlanId",
"modifier" : "modifier",
"associatedStagesCount" : 0,
"dayQuotaRequest" : 6,
"permission" : "permission",
"rateRps" : 5,
"usagePlanName" : "usagePlanName",
"monthQuotaRequest" : 1,
"tenantId" : "tenantId",
"disabled" : true,
"usagePlanDescription" : "usagePlanDescription",
"quotaCondition" : "quotaCondition",
"actionName" : "actionName"
} ]
}
기본 Usage Plan 설정
URL
PUT https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}/usage-plan
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
{
"monthQuotaRequest" : 1,
"dayQuotaRequest" : 6,
"rateRps" : 0,
"quotaCondition" : "quotaCondition"
}
응답 코드
- 200
응답 바디
{
"stage" : {
"canaryDeployedTime" : "2000-01-23T04:56:07.000+00:00",
"modifier" : "modifier",
"canaryEndpointDomain" : "canaryEndpointDomain",
"canaryThrottleRps" : 5,
"cacheTtlSec" : 0,
"stageName" : "stageName",
"throttleRps" : 4,
"monthQuotaRequest" : 9,
"canaryCacheTtlSec" : 6,
"canaryDistributionRate" : 5.962134,
"apiId" : "apiId",
"stageId" : "stageId",
"deployedStageDeploymentNo" : 7,
"useDistributionRate" : true,
"canaryDeploymentDescription" : "canaryDeploymentDescription",
"dayQuotaRequest" : 2,
"isMaintenance" : true,
"rateRps" : 3,
"endpointDomain" : "endpointDomain",
"ipAclList" : "ipAclList",
"canaryDeploymentNo" : 1,
"regTime" : "2000-01-23T04:56:07.000+00:00",
"response" : "response",
"canaryConditions" : [ {
"parameterName" : "parameterName",
"parameterCode" : "REQUEST_HEADER",
"parameterValue" : "parameterValue"
} ],
"tenantId" : "tenantId",
"ipAclCode" : "ALLOWED",
"statusCode" : 2,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
}
Stage 설정 수정
URL
PUT https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/stages/{stage-id}
요청 파라미터
이름 | 위치 | 필수여부 | 타입 | 설명 |
---|---|---|---|---|
productId | path | Y | String | Product Id 길이(최대/최소): 0/10 |
apiId | path | Y | String | Api Id 길이(최대/최소): 0/10 |
stageId | path | Y | String | Stage Id 길이(최대/최소): 0/10 |
요청 바디
{
"cacheTtlSec" : 0,
"ipAclList" : "ipAclList",
"throttleRps" : 6,
"response" : "response",
"isMaintenance" : true,
"ipAclCode" : "ALLOWED",
"endpointDomain" : "endpointDomain",
"statusCode" : 1,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
응답 코드
- 200
응답 바디
{
"stage" : {
"canaryDeployedTime" : "2000-01-23T04:56:07.000+00:00",
"modifier" : "modifier",
"canaryEndpointDomain" : "canaryEndpointDomain",
"canaryThrottleRps" : 5,
"cacheTtlSec" : 0,
"stageName" : "stageName",
"throttleRps" : 4,
"monthQuotaRequest" : 9,
"canaryCacheTtlSec" : 6,
"canaryDistributionRate" : 5.962134,
"apiId" : "apiId",
"stageId" : "stageId",
"deployedStageDeploymentNo" : 7,
"useDistributionRate" : true,
"canaryDeploymentDescription" : "canaryDeploymentDescription",
"dayQuotaRequest" : 2,
"isMaintenance" : true,
"rateRps" : 3,
"endpointDomain" : "endpointDomain",
"ipAclList" : "ipAclList",
"canaryDeploymentNo" : 1,
"regTime" : "2000-01-23T04:56:07.000+00:00",
"response" : "response",
"canaryConditions" : [ {
"parameterName" : "parameterName",
"parameterCode" : "REQUEST_HEADER",
"parameterValue" : "parameterValue"
} ],
"tenantId" : "tenantId",
"ipAclCode" : "ALLOWED",
"statusCode" : 2,
"enabledContentEncoding": true,
"minimumCompressionSize": 0
}
}
이 문서가 도움이 되었습니까?