[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-18。"],[],[],null,["# Regional endpoints\n\nStorage Transfer Service agent-based transfers support\n[Cloud Storage regional endpoints](/storage/docs/regional-endpoints). When a\nCloud Storage regional endpoint is specified, all data transfer traffic\nthrough the agent to or from a Cloud Storage bucket remains\nwithin that Google Cloud region. Any Cloud Storage buckets\ninvolved in the transfer, including intermediate buckets for inter-file system\ntransfers, must be located in the specified region, or the transfer fails.\n\nWhen a regional endpoint is not specified, the transfer agent connects to the\nglobal endpoint, which routes traffic optimally but does not guarantee regional\nconfinement of the data in transit.\n\nRegional endpoints are not supported in agentless transfers.\n\nSpecify a regional endpoint\n---------------------------\n\nEndpoints are specified at the transfer agent level. The agent must be installed\nusing the `docker` command.\n\nTo specify a regional endpoint, use the `--gcs-api-endpoint` flag when\ninstalling a transfer agent using `docker run`: \n\n```\nsudo docker run --ulimit memlock=64000000 -d --rm \\\n--volumes-from gcloud-config \\\n-v HOST_DIRECTORY:CONTAINER_DIRECTORY \\\ngcr.io/cloud-ingest/tsop-agent:latest \\\n--project-id=PROJECT_ID \\\n--hostname=$(hostname) \\\n--agent-pool=POOL_NAME \\\n--gcs-api-endpoint=storage.LOCATION.rep.googleapis.com\n```\n\nThe flag accepts all Cloud Storage single regions, as well as the\n`US` multi-region and the `EU` multi-region. See\n[Bucket locations](/storage/docs/locations) for a complete list.\n\nRegional endpoint consistency in agent pools\n--------------------------------------------\n\nWhen specifying an agent pool for a transfer agent, be aware that\nStorage Transfer Service doesn't enforce uniform regional endpoints across all agents\nin that pool. This means you could inadvertently mix agents that have a specific\nregional endpoint with agents that don't within the same pool; as a result, the\npool may route traffic through the global endpoint.\n\nTo ensure traffic remains within the desired region, only include agents with\nthe same regional endpoint in a given agent pool."]]
