lewzylu
lewzylu

cos-php-sdk-v5接口文档

基本 API 描述

关于文章中出现的 SecretId、SecretKey、Bucket 等名称的含义和获取方式请参考：COS 术语信息

获取Bucket列表

方法原型

public Guzzle\Service\Resource\Model listBucket(array $args = array())

请求示例

//获取bucket列表
$result = $cosClient->listBuckets();

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Owner] => Array
                (
                    [ID] => qcs::cam::uin/3210232098:uin/3210232098
                    [DisplayName] => 3210232098
                )

            [Buckets] => Array
                (
                    [0] => Array
                        (
                            [Name] => accesslog-10055004
                            [Location] => ap-shanghai
                            [CreationDate] => 2016-07-29T03:09:54Z
                        )

                    [1] => Array
                        (
                            [Name] => accesslogbj-10055004
                            [Location] => ap-beijing
                            [CreationDate] => 2017-08-02T04:00:24Z
                        )

                )

            [RequestId] => NWE3YzgxZmFfYWZhYzM1MGFfMzc3MF9iOGY5OQ==
        )

)

创建Bucket

方法原型

// 创建桶
public Guzzle\Service\Resource\Model createBucket(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Acl ACL权限控制 string 否

请求示例

//创建桶
//bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$result = $cosClient->createBucket(array('Bucket' => 'testbucket-125000000'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Location] => 
            [RequestId] => NWE3YzgzMTZfMTdiMjk0MGFfNTQ1OF8xNjEyYmE=
        )
)

删除Bucket

方法原型

// 删除桶
public Guzzle\Service\Resource\Model deleteBucket(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket 是 string bucket名称

请求示例

//删除桶
//bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$result = $cosClient->deleteBucket(array('Bucket' => 'testbucket-125000000'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestId] => NWE3YzgzMTZfMTdiMjk0MGFfNTQ2MF8xNjBjZTI=
        )
)

简单文件上传

方法原型

public Guzzle\Service\Resource\Model putObject(array $args = array())

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket Bucket 名称，由数字和小写字母以及中划线 "-" 构成 string 是
Body 上传文件的内容，可以为文件流或字节流 file/string 是
Key 上传文件的路径名，默认从 Bucket 开始 string 是
ACL 设置文件的 ACL，如 'private，public-read'，'public-read-write' string 否
GrantFullControl 赋予指定账户对文件的读写权限 string 否
GrantRead 赋予指定账户对文件读权限 string 否
GrantWrite 赋予指定账户对文件的写权限 string 否
StorageClass 设置文件的存储类型，STANDARD,STANDARD_IA，NEARLINE，默认值：STANDARD String 否
Expires 设置 Content-Expires string 否
CacheControl 缓存策略，设置 Cache-Control string 否
ContentType 内容类型，设置 Content-Type string 否
ContentDisposition 文件名称，设置 Content-Disposition string 否
ContentEncoding 编码格式，设置 Content-Encoding string 否
ContentLanguage 语言类型，设置 Content-Language string 否
ContentLength 设置传输长度 string 否
ContentMD5 设置上传文件的 MD5 值用于校验 string 否
Metadata 用户自定义的文件元信息 array 否
ServerSideEncryption 服务端加密方法 string 否

请求示例

// 从内存中上传
#putObject
try {
    $result = $cosClient->putObject(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        'Key' => 'string',
        'Body' => 'Hello World!',
        'CacheControl' => 'string',
        'ContentDisposition' => 'string',
        'ContentEncoding' => 'string',
        'ContentLanguage' => 'string',
        'ContentLength' => integer,
        'ContentType' => 'string',
        'Expires' => 'mixed type: string (date format)|int (unix timestamp)|\DateTime',
        'GrantFullControl' => 'string',
        'GrantRead' => 'string',
        'GrantWrite' => 'string',
        'Metadata' => array(
            'string' => 'string',
        ),
        'StorageClass' => 'string',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}
 上传本地文件
#putObject
try {
    $result = $cosClient->putObject(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        'Key' => 'string',
        'Body' => fopen('./hello.txt', 'rb'),
        'CacheControl' => 'string',
        'ContentDisposition' => 'string',
        'ContentEncoding' => 'string',
        'ContentLanguage' => 'string',
        'ContentLength' => integer,
        'ContentType' => 'string',
        'Expires' => 'mixed type: string (date format)|int (unix timestamp)|\DateTime',
        'GrantFullControl' => 'string',
        'GrantRead' => 'string',
        'GrantWrite' => 'string',
        'Metadata' => array(
            'string' => 'string',
        ),
        'StorageClass' => 'string',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Expiration] => 
            [ETag] => "ed076287532e86365e841e92bfc50d8c"
            [ServerSideEncryption] => AES256
            [VersionId] => 
            [SSECustomerAlgorithm] => 
            [SSECustomerKeyMD5] => 
            [SSEKMSKeyId] => 
            [RequestCharged] => 
            [RequestId] => NWE3Yzg0M2NfOTcyMjViNjRfYTE1YV8xNTQzYTY=
            [ObjectURL] => http://testbucket-1252448703.cos.cn-south.myqcloud.com/11%2F%2F32%2F%2F43
        )
)

分块文件上传

分块文件上传是通过将文件拆分成多个小块进行上传，多个小块可以并发上传, 最大支持40TB。

分块文件上传的步骤为:

  1. 初始化分块上传，获取uploadid。(createMultipartUpload)
  2. 分块数据上传(可并发). (uploadPart)
  3. 完成分块上传。 (completeMultipartUpload)

另外还包含获取已上传分块(listParts), 终止分块上传(abortMultipartUpload)。

方法原型

// 初始化分块上传
public Guzzle\Service\Resource\Model createMultipartUpload(array $args = array());

// 上传数据分块
public Guzzle\Service\Resource\Model uploadPart(array $args = array());
            
// 完成分块上传
public Guzzle\Service\Resource\Model completeMultipartUpload(array $args = array());

// 罗列已上传分块
public Guzzle\Service\Resource\Model listParts(array $args = array());

// 终止分块上传
public Guzzle\Service\Resource\Model abortMultipartUpload(array $args = array());

上传文件

请求示例

//上传文件
try {
    $result = $cosClient->upload(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        $bucket='testbucket-1252448703',
        $key = '111.txt',
        $body = fopen('./hello.txt', 'rb'),
        $options = array(
            "ACL"=>'private',
            'CacheControl' => 'private'));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

单文件小于5M时，使用单文件上传
反之使用分片上传

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Location] => testbucket-1252448703.cos.cn-south.myqcloud.com/111.txt
            [Bucket] => testbucket
            [Key] => 111.txt
            [ETag] => "715691804ee474f2eb94adb2c5c01155-1"
            [Expiration] => 
            [ServerSideEncryption] => AES256
            [VersionId] => 
            [SSEKMSKeyId] => 
            [RequestCharged] => 
            [RequestId] => NWE3Yzg0YTRfOTUyMjViNjRfNWYyZF8xNTI5ZDQ=
        )
)

下载文件

将文件下载到本地或者下载到内存中.

方法原型

// 下载文件
public Guzzle\Service\Resource\Model getObject(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 对象名称 string 是
SaveAs 保存到本地的本地文件路径 string 否
VersionId 对象版本号 string 否

请求示例

// 下载文件到内存
$result = $cosClient->getObject(array(
    //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
    'Bucket' => 'testbucket-125000000',
    'Key' => 'hello.txt'));
echo($result['Body'])

// 下载文件到本地
$result = $cosClient->getObject(array(
    //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
    'Bucket' => 'testbucket-125000000',
    'Key' => 'hello.txt',
    'SaveAs' => './hello.txt'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Body] =>
            [DeleteMarker] => 
            [AcceptRanges] => bytes
            [Expiration] => 
            [Restore] => 
            [LastModified] => Fri, 09 Feb 2018 01:10:56 GMT
            [ContentLength] => 5242880
            [ETag] => "715691804ee474f2eb94adb2c5c01155-1"
            [MissingMeta] => 
            [VersionId] => 
            [CacheControl] => private
            [ContentDisposition] => attachment; filename*="UTF-8''111.txt"
            [ContentEncoding] => 
            [ContentLanguage] => 
            [ContentRange] => 
            [ContentType] => text/plain; charset=utf-8
            [Expires] => 
            [WebsiteRedirectLocation] => 
            [ServerSideEncryption] => AES256
            [SSECustomerAlgorithm] => 
            [SSECustomerKeyMD5] => 
            [SSEKMSKeyId] => 
            [StorageClass] => 
            [RequestCharged] => 
            [ReplicationStatus] => 
            [RequestId] => NWE3Yzg4ODlfMThiMjk0MGFfMmI3OV8xNWQxNDg=
        )
)

删除文件

删除COS上的对象.

方法原型

// 删除文件
public Guzzle\Service\Resource\Model deleteObject(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 对象名称 string 是
VersionId 对象版本号 string 否

请求示例

// 删除COS对象
$result = $cosClient->deleteObject(array(
    //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
    'Bucket' => 'testbucket-125000000',
    'Key' => 'hello.txt'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [DeleteMarker] => 
            [VersionId] => 
            [RequestCharged] => 
            [RequestId] => NWE3Yzg5MzJfY2FhMzNiMGFfNDVjOV8yY2QyMzg=
        )
)

获取对象属性

查询获取COS上的对象属性

方法原型

// 获取文件属性
public Guzzle\Service\Resource\Model headObject(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 对象名称 string 是
VersionId 对象版本号 string 否

返回结果示例

Array
(
    [data:protected] => Array
        (
            [DeleteMarker] => 
            [AcceptRanges] => 
            [Expiration] => 
            [Restore] => 
            [LastModified] => Thu, 08 Feb 2018 17:34:53 GMT
            [ContentLength] => 12
            [ETag] => "ed076287532e86365e841e92bfc50d8c"
            [MissingMeta] => 
            [VersionId] => 
            [CacheControl] => 
            [ContentDisposition] => 
            [ContentEncoding] => 
            [ContentLanguage] => 
            [ContentType] => application/octet-stream
            [Expires] => 
            [WebsiteRedirectLocation] => 
            [ServerSideEncryption] => AES256
            [SSECustomerAlgorithm] => 
            [SSECustomerKeyMD5] => 
            [SSEKMSKeyId] => 
            [StorageClass] => 
            [RequestCharged] => 
            [ReplicationStatus] => 
            [RequestId] => NWE3YzhhM2RfMWViZTk0MGFfNWMzMF8xNTFiZDg=
        )
)

请求示例

// 获取COS文件属性
 //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$result $cosClient->headObject(array('Bucket' => 'testbucket-125000000', 'Key' => 'hello.txt'));

查询Bucket是否存在

查询获取COS上的Bucket是否存在

方法原型

// 获取文件属性
public Guzzle\Service\Resource\Model headBucket(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket 对象版本号 string 是

请求示例

// 获取COS文件属性
 //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$result $cosClient->headBucket(array('Bucket' => 'testbucket-125000000'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestId] => NWE3YzhhN2VfY2VhMzNiMGFfMmNmXzJjNzc3Zg==
        )
)

获取文件列表

查询获取COS上的文件列表

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model listObjects(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Delimiter 分隔符 string 否
Marker 标记 string 否
MaxKeys 最大对象个数 int 否
Prefix 前缀 string 否

请求示例

// 获取bucket下成员
//bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$result = $cosClient->listObjects(array('Bucket' => 'testbucket-125000000'));

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Name] => testbucket-1252448703
            [Prefix] => 
            [Marker] => 
            [MaxKeys] => 1000
            [IsTruncated] => 
            [Contents] => Array
                (
                    [0] => Array
                        (
                            [Key] => 11/32/43
                            [LastModified] => 2018-02-08T17:09:16.000Z
                            [ETag] => "ed076287532e86365e841e92bfc50d8c"
                            [Size] => 12
                            [Owner] => Array
                                (
                                    [ID] => 1252448703
                                    [DisplayName] => 1252448703
                                )

                            [StorageClass] => STANDARD
                        )

                    [1] => Array
                        (
                            [Key] => 111
                            [LastModified] => 2018-02-08T17:41:11.000Z
                            [ETag] => "ed076287532e86365e841e92bfc50d8c"
                            [Size] => 12
                            [Owner] => Array
                                (
                                    [ID] => 1252448703
                                    [DisplayName] => 1252448703
                                )

                            [StorageClass] => STANDARD
                        )

                    [2] => Array
                        (
                            [Key] => 111.txt
                            [LastModified] => 2018-02-08T17:11:00.000Z
                            [ETag] => "715691804ee474f2eb94adb2c5c01155-1"
                            [Size] => 5242880
                            [Owner] => Array
                                (
                                    [ID] => 1252448703
                                    [DisplayName] => 1252448703
                                )

                            [StorageClass] => STANDARD
                        )

                )

            [RequestId] => NWE3YzhiYjdfMWJiMjk0MGFfMzA4M18xNjdiNDM=
        )
)

putBucketACL

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model putBucketACL(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
ACL ACL权限控制 string 否
GrantRead 赋予被授权者读的权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否
GrantWrite 赋予被授权者写的权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否
GrantFullControl 赋予被授权者读写权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否

请求示例

#putBucketACL
try {
    $result = $cosClient->PutBucketAcl(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        'Grants' => array(
            array(
                'Grantee' => array(
                    'DisplayName' => 'qcs::cam::uin/327874225:uin/327874225',
                    'ID' => 'qcs::cam::uin/327874225:uin/327874225',
                    'Type' => 'CanonicalUser',
                ),
                'Permission' => 'FULL_CONTROL',
            ),
            // ... repeated
        ),
        'Owner' => array(
            'DisplayName' => 'qcs::cam::uin/3210232098:uin/3210232098',
            'ID' => 'qcs::cam::uin/3210232098:uin/3210232098',
        ),));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestId] => NWE3YzhiZTZfZDRiMjk0MGFfODMwXzJjODllYw==
        )
)

getBucketACL

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model getBucketACL(array $args = array());

请求参数

字段名 类型 默认值 是否必填字段 描述
Bucket string 无 是 bucket名称

请求示例

#getBucketACL
try {
    $result = $cosClient->GetBucketAcl(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Owner] => Array
                (
                    [ID] => qcs::cam::uin/3210232098:uin/3210232098
                    [DisplayName] => qcs::cam::uin/3210232098:uin/3210232098
                )

            [Grants] => Array
                (
                    [0] => Array
                        (
                            [Grantee] => Array
                                (
                                    [ID] => qcs::cam::uin/327874225:uin/327874225
                                    [DisplayName] => qcs::cam::uin/327874225:uin/327874225
                                )

                            [Permission] => FULL_CONTROL
                        )

                )

            [RequestId] => NWE3YzhjMTRfYzdhMzNiMGFfYjdiOF8yYzZmMzU=
        )
)

putObjectACL

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model putObjectACL(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 上传文件的路径名，默认从 Bucket 开始 string 是
ACL ACL权限控制 string 否
GrantRead 赋予被授权者读的权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否
GrantWrite 赋予被授权者写的权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否
GrantFullControl 赋予被授权者读写权限。格式：id=" ",id=" "；当需要给子账户授权时，id="qcs::cam::uin/:uin/"，当需要给根账户授权时，id="qcs::cam::uin/:uin/"，例如：'id="qcs::cam::uin/123:uin/123", id="qcs::cam::uin/123:uin/456"' string 否

请求示例

#putObjectACL
try {
    $result = $cosClient->PutObjectAcl(array(
        'Bucket' => 'testbucket-1252448703',
        'Key' => '111.txt',
        'Grants' => array(
            array(
                'Grantee' => array(
                    'DisplayName' => 'qcs::cam::uin/327874225:uin/327874225',
                    'ID' => 'qcs::cam::uin/327874225:uin/327874225',
                    'Type' => 'CanonicalUser',
                ),
                'Permission' => 'FULL_CONTROL',
            ),
            // ... repeated
        ),
        'Owner' => array(
            'DisplayName' => 'qcs::cam::uin/3210232098:uin/3210232098',
            'ID' => 'qcs::cam::uin/3210232098:uin/3210232098',
        ),));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

getObjectACL

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model getObjectACL(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 文件名称 string 是

请求示例

#getObjectACL
try {
    $result = $cosClient->getObjectAcl(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        'Key' => '11'));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Owner] => Array
                (
                    [ID] => qcs::cam::uin/3210232098:uin/3210232098
                    [DisplayName] => qcs::cam::uin/3210232098:uin/3210232098
                )

            [Grants] => Array
                (
                    [0] => Array
                        (
                            [Grantee] => Array
                                (
                                    [ID] => qcs::cam::uin/327874225:uin/327874225
                                    [DisplayName] => qcs::cam::uin/327874225:uin/327874225
                                )

                            [Permission] => FULL_CONTROL
                        )

                )

            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjU5OF8yYzlkMmE=
        )
)

putBucketCors

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model putBucketCors(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
CORSRules CORS规则 array 是
AllowedMethods 允许的 HTTP 操作，枚举值：GET，PUT，HEAD，POST，DELETE array 否
AllowedOrigins 允许的访问来源，支持通配符 * 格式为：协议://域名[:端口]如：http://www.qq.com array 否
AllowedHeaders 在发送 OPTIONS 请求时告知服务端，接下来的请求可以使用哪些自定义的 HTTP 请求头部，支持通配符 * array 否
ExposeHeaders 设置浏览器可以接收到的来自服务器端的自定义头部信息 array 否
MaxAgeSeconds 设置 OPTIONS 请求得到结果的有效期 string 否
ID 配置规则的 ID string 否

请求示例

###putBucketCors
try {
    $result = $cosClient->putBucketCors(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        // CORSRules is required
        'CORSRules' => array(
            array(
                'AllowedHeaders' => array('*',),
            // AllowedMethods is required
            'AllowedMethods' => array('Put', ),
            // AllowedOrigins is required
            'AllowedOrigins' => array('*', ),
            'ExposeHeaders' => array('*', ),
            'MaxAgeSeconds' => 1,
        ),
        // ... repeated
    ),
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

getBucketCors

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model getBucketCors(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是

请求示例

#getBucketCors
try {
    $result = $cosClient->getBucketCors(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [CORSRules] => Array
                (
                    [0] => Array
                        (
                            [ID] => 1234
                            [AllowedHeaders] => Array
                                (
                                    [0] => *
                                )

                            [AllowedMethods] => Array
                                (
                                    [0] => PUT
                                )

                            [AllowedOrigins] => Array
                                (
                                    [0] => http://www.qq.com
                                )

                        )

                )

            [RequestId] => NWE3YzhkMmRfMTdiMjk0MGFfNTQzZl8xNWUwMGU=
        )
)

deleteBucketCors

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model deleteBucketCors(array $args = array());

请求参数

  • params (Object) ： 参数列表
    • Bucket —— (String) ： Bucket 名称

请求示例

#deleteBucketCors
try {
    $result = $cosClient->deleteBucketCors(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

复制对象

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model copyObject(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket Bucket 名称，由数字和小写字母以及中划线 "-" 构成 string 是
CopySource 复制来源 string 是
Key 上传文件的路径名，默认从 Bucket 开始 string 是
ACL 设置文件的 ACL，如 'private，public-read'，'public-read-write' string 否
GrantFullControl 赋予指定账户对文件的读写权限 string 否
GrantRead 赋予指定账户对文件读权限 string 否
GrantWrite 赋予指定账户对文件的写权限 string 否
StorageClass 设置文件的存储类型，STANDARD,STANDARD_IA，NEARLINE，默认值：STANDARD String 否
Expires 设置 Content-Expires string 否
CacheControl 缓存策略，设置 Cache-Control string 否
ContentType 内容类型，设置 Content-Type string 否
ContentDisposition 文件名称，设置 Content-Disposition string 否
ContentEncoding 编码格式，设置 Content-Encoding string 否
ContentLanguage 语言类型，设置 Content-Language string 否
ContentLength 设置传输长度 string 否
ContentMD5 设置上传文件的 MD5 值用于校验 string 否
Metadata 用户自定义的文件元信息 array 否
ServerSideEncryption 服务端加密方法 string 否

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket Bucket 名称，由数字和小写字母以及中划线 "-" 构成 string 是
CopySource 复制来源 string 是
Key 上传文件的路径名，默认从 Bucket 开始 string 是
ACL 设置文件的 ACL，如 'private，public-read'，'public-read-write' string 否
GrantFullControl 赋予指定账户对文件的读写权限 string 否
GrantRead 赋予指定账户对文件读权限 string 否
GrantWrite 赋予指定账户对文件的写权限 string 否
StorageClass 设置文件的存储类型，STANDARD,STANDARD_IA，NEARLINE，默认值：STANDARD String 否
Expires 设置 Content-Expires string 否
CacheControl 缓存策略，设置 Cache-Control string 否
ContentType 内容类型，设置 Content-Type string 否
ContentDisposition 文件名称，设置 Content-Disposition string 否
ContentEncoding 编码格式，设置 Content-Encoding string 否
ContentLanguage 语言类型，设置 Content-Language string 否
ContentLength 设置传输长度 string 否
ContentMD5 设置上传文件的 MD5 值用于校验 string 否
Metadata 用户自定义的文件元信息 array 否
ServerSideEncryption 服务端加密方法 string 否

请求示例

#copyobject
#简单copy接口
try {
    $result = $cosClient->copyObject(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' => 'testbucket-125000000',
        // CopySource is required
        'CopySource' => 'lewzylu03-1252448703.cos.ap-guangzhou.myqcloud.com/tox.ini',
        // Key is required
        'Key' => 'string',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

#copy
#大于5g会自动使用分块copy
try {
    $result = $cosClient->Copy($bucket = 'lewzylu01-1252448703',
        $key = 'string',
        $copysource = 'lewzylu02-1252448703.cos.ap-guangzhou.myqcloud.com/test1G',
        $options = array('VersionId'=>'MTg0NDY3NDI1NTk0MzUwNDQ1OTg'));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

putBucketLifecycle

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model putBucketLifecycle(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket Bucket 名称，由数字和小写字母以及中划线 "-" 构成 string 是
Rules 设置对应的规则，包括 ID，Filter，Status，Expiration，Transition，NoncurrentVersionExpiration，NoncurrentVersionTransition，AbortIncompleteMultipartUpload array 是
ID 配置规则的 ID string 否
Filter 用于描述规则影响的 Object 集合 array 是
Status 设置 Rule 是否启用，可选值为 Enabled 或者 Disabled string 是
Expiration 设置 Object 过期规则，可以指定天数 Days 或者指定日期 Date array 否
Transition 设置 Object 转换存储类型规则，可以指定天数 Days 或者指定日期 Date，StorageClass 可选 Standard_IA， Nearline array 否

请求示例

#putBucketLifecycle
try {
    $result = $cosClient->putBucketLifecycle(array(
    //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
    'Bucket' => 'testbucket-125000000',
    // Rules is required
    'Rules' => array(
        array(
            'Expiration' => array(
                'Days' => 1,
            ),
            'ID' => 'id1',
            'Filter' => array(
                'Prefix' => 'documents/'
            ),
            // Status is required
            'Status' => 'Enabled',
            'Transitions' => array(
                array(
                    'Days' => 200,
                    'StorageClass' => 'NEARLINE')),
            // ... repeated
        ),
    )));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

getBucketLifecycle

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model getBucketLifecycle(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是

请求示例

#getBucketLifecycle
try {
    $result = $cosClient->getBucketLifecycle(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' =>'testbucket-125000000',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Rules] => Array
                (
                    [0] => Array
                        (
                            [ID] => id1
                            [Filter] => Array
                                (
                                    [Prefix] => documents/
                                )

                            [Status] => Enabled
                            [Transition] => Array
                                (
                                    [Days] => 200
                                    [StorageClass] => NEARLINE
                                )

                            [Expiration] => Array
                                (
                                    [Days] => 1000
                                )

                        )

                )

            [RequestId] => NWE3YzhlZjNfY2FhMzNiMGFfNDVkNF8yZDIxODE=
        )
)

deleteBucketLifecycle

方法原型

// 获取文件列表
public Guzzle\Service\Resource\Model deleteBucketLifecycle(array $args = array());

请求参数

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是

请求示例

#deleteBucketLifecycle
try {
    $result = $cosClient->deleteBucketLifecycle(array(
        //bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
        'Bucket' =>'testbucket-125000000',
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

获得object下载url

获得object带签名的下载url

请求示例

//获得object的下载url
//bucket的命名规则为{name}-{appid} ，此处填写的存储桶名称必须为此格式
$bucket =  'testbucket-125000000';
$key = 'hello.txt';
$region = 'cn-south';
$url = "/{$key}";
$request = $cosClient->get($url);
$signedUrl = $cosClient->getObjectUrl($bucket, $key, '+10 minutes');

使用临时密钥

$cosClient = new Qcloud\Cos\Client(
    array(
        'region' => 'cn-south',
        'timeout' => ,
        'credentials'=> array(
            'appId' => '',
            'secretId'    => '',
            'secretKey' => '',
            'token' => '')));

恢复归档文件

方法原型

//  恢复归档文件
public Guzzle\Service\Resource\Model deleteObject(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Key 对象名称 string 是
Days 保存时间 integer 是
Tier 恢复类型 string 否

请求示例

  try {
    $result = $cosClient->restoreObject(array(
        // Bucket is required
        'Bucket' => 'lewzylu02',
        // Objects is required
        'Key' => '11',
        'Days' => 7,
        'CASJobParameters' => array(
            'Tier' =>'Bulk'
        )
    ));
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

开启多版本

方法原型

// 开启多版本
public Guzzle\Service\Resource\Model putBucketVersioning(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Status 多版本状态 string 是

请求示例

#putBucketVersioning
try {
    $result = $cosClient->putBucketVersioning(
    array('Bucket' => 'lewzylu02',
    'Status' => 'Enabled')
    );
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [RequestCharged] => 
            [RequestId] => NWE3YzhjZDdfY2JhMzNiMGFfNjVhOV8yZDJhNjY=
        )
)

获取bucket版本

方法原型

// 获取bucket版本
public Guzzle\Service\Resource\Model getBucketVersioning(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是

请求示例

try {
    $result = $cosClient->getBucketVersioning(
        array('Bucket' => 'lewzylu02',)
    );
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
    [data:protected] => Array
        (
            [Status] => Enabled
            [RequestId] => NWE3YzhmZTVfNjIyNWI2NF80YzQ3XzJkNjU4NQ==
        )
)

打印各个版本的文件列表

方法原型

// 打印各个版本的文件列表
public Guzzle\Service\Resource\Model listObjectVersions(array $args = array());

请求参数

$args是包含以下字段的关联数组：

参数名称 描述 类型 是否必填字段
Bucket bucket名称 string 是
Delimiter 分隔符 string 否
Marker 标记 string 否
MaxKeys 最大对象个数 int 否
Prefix 前缀 string 否

请求示例

try {
    $result = $cosClient->listObjectVersions(
        array('Bucket' => 'lewzylu02',
            'Prefix'=>'test1G')
    );
    print_r($result);
} catch (\Exception $e) {
    echo "$e\n";
}

返回结果示例

Array
(
   [data:protected] => Array
        (
            [Name] => lewzylu02-1252448703
            [Prefix] => test1G
            [KeyMarker] => 
            [VersionIdMarker] => 
            [MaxKeys] => 1000
            [IsTruncated] => 
            [Versions] => Array
                (
                    [0] => Array
                        (
                            [Key] => test1G
                            [VersionId] => MTg0NDY3NDI1NTg1ODc4Nzk3NjI
                            [IsLatest] => 1
                            [LastModified] => 2018-01-05T03:07:51.000Z
                            [ETag] => "202cb962ac59075b964b07152d234b70"
                            [Size] => 3
                            [StorageClass] => STANDARD
                            [Owner] => Array
                                (
                                    [UID] => 1252448703
                                )

                        )

                    [1] => Array
                        (
                            [Key] => test1G
                            [VersionId] => MTg0NDY3NDI1NTk0MzI3NDU3NTk
                            [IsLatest] => 
                            [LastModified] => 2017-12-26T08:26:50.000Z
                            [ETag] => "13ddf6552868644926ba606cd287106b-1"
                            [Size] => 5242880
                            [StorageClass] => STANDARD
                            [Owner] => Array
                                (
                                    [UID] => 1252448703
                                )

                        )

                    [2] => Array
                        (
                            [Key] => test1G
                            [VersionId] => MTg0NDY3NDI1NTk0MzI3ODAzODc
                            [IsLatest] => 
                            [LastModified] => 2017-12-26T08:26:16.000Z
                            [ETag] => "3c86b7371340b2174b875fa7bcc0bd9a-1"
                            [Size] => 5242880
                            [StorageClass] => STANDARD
                            [Owner] => Array
                                (
                                    [UID] => 1252448703
                                )

                        )
                )

            [RequestId] => NWE3YzkwMGFfMTliYjk0MGFfMWUwOWRfMmJlZWIx
        )
)

你可能感兴趣的:(cos-php-sdk-v5接口文档)

  • 【乐吾乐大屏可视化组态编辑器】API接口文档（pgsql） 乐吾乐科技 2D可视化组态编辑器编辑器前端流程图开源交互数据可视化
    API接口文档（pgsql）在线使用：https://v.le5le.com/采用前后端分离架构，乐吾乐后端服务提供一整套完整的web组态编辑器的所有数据接口，包含2D/3D图纸接口服务、文件接口服务和用户接口服务等，安装包版本提供后端可执行程序文件，后端源码版提供Java源码。用户也可以自行按照接口文档去实现部分必要的接口，参考接口文档如下：全局规则默认：所有接口返回通过是否包含error字段来
  • Swagger配置API接口文档 码农OvO java
    Swagger配置API接口文档文章目录Swagger配置API接口文档一：概述核心组件：优势：二：实验步骤1.导入依赖2.代码生成器3.添加配置信息4.解决版本冲突问题5.编写Controller测试6.启动项目7.Swagger相关注解@Api@ApiOperation@ApiParam@ApiImplicitParam`@ApiParam`注解和`@ApiImplicitParam`注解区别
  • Swagger测试文档使用 @泽栖 Swagger
    文章目录介绍：使用：导入knife4j的maven坐标在配置类中加入knife4j相关配置设置静态资源映射，否则接口文档页面无法访问常用注解优化介绍：Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务(https://swagger.io/)。它的主要作用是：使得前后端分离开发更加方便，有利于团队协作接口的文档在线自动生成，降低后端开发人员编写接口文档
  • 后台数据管理系统 - 项目架构设计 风流野趣fly vue.js前端javascriptvscodecss前端框架webpack
    后台数据管理系统-项目架构设计在线演示：黑马程序员-大事件接口文档:登录-黑马程序员-大事件接口根路径：http://big-event-vue-api-t.itheima.net本项目的技术栈本项目技术栈基于ES6、vue3、pinia、vue-router、vite、axios和element-plus项目页面介绍pnpm包管理器-创建项目一些优势：比同类工具快2倍左右、节省磁盘空间...pn
  • Knife4j自动生成API接口文档，springboot3配置Knife4j 枫斗. javaspringboot
    Knife4j自动生成API接口文档Knife4j是一个为Java应用程序提供API文档生成和可视化的开源工具，它基于Swagger和OpenAPI规范。以下是Knife4j的基本使用文档，包括安装、配置和使用指南。1.概述Knife4j是为Java应用程序提供API文档生成、测试、监控的增强解决方案，它整合了SwaggerUI、SwaggerEditor、SwaggerCodegen的功能，同时
  • 话费接口API对接流程是什么？又有哪些优势？ 三十一号鼓手 lispintellijideajavaopentsdb大数据
    话费接口API对接流程前期准备找一家专业做话费充值的公司，联系其商务了解对接的具体情况，包括合作模式、话费价格、消耗及打款金额是否可以开票、对接时是否有技术配合等开户与对接确定合作后在话费充值平台进行开户，获取账户参数及接口文档开始对接接口测试对接完成后进行接口测试，测试成功后可正式提交话费进行充值话费接口API优势充值范围可自动配置，支持三大运营商的话费充值话费充值安全稳定性有保障，基础硬件设施
  • 如何使用Smart-Doc高效生成Java WebSocket接口文档 shalousun smart-docjavawebsocketjava文档工具零注解
    前言Smart-Doc是一款强大的文档生成工具，可以帮助开发者轻松地为Java项目生成清晰、详细的API文档。随着WebSocket技术的普及，Smart-Doc在3.0.7版本开始也增加了对WebSocket接口的支持。本文将详细介绍如何使用Smart-Doc生成JavaWebSocket接口的文档，并提供一个完整的WebSocket服务端示例。WebSocket技术概览首先，让我们简单了解一下
  • java写入word表格(poi-tl) 柴米油盐那点事儿 javaword
    1.导入依赖com.deepoovepoi-tl1.12.02.代码自己创建模板。放在（resource/file）@GetMapping("/api/word")@ApiOperation(value="接口文档下载",produces="application/octet-stream")@ApiOperationSupport(order=1)publicvoiddownload(@Requ
  • PHP对接语音验证码接口DEMO示例 李小慧互亿无线
    为了最大限度的提升验证码短信的到达率，可以在对接验证码短信外另外对接语音验证码，在短信因某种原因失败未送达客户手机语音验证码是不错的备选方案。有效的减少客户流失率。//接口类型：互亿无线语音验证码接口。//账户注册：请通过该地址开通账户http://user.ihuyi.com/?h9Dkn//注意事项：//（1）调试期间，请仔细阅读接口文档；//（2）请使用APIID及APIKEY来调用接口，可
  • 一款好看的EMlog系统博客网站微信小程序源码v1.1 dddaaxx 程序源码
    介绍：这是一个简洁的程序，所以给它取了个英文名叫Brief，需要配合EMlog后端，所以EMlog附带了一款非常好看的大前端模板。Brief使用emlog（6.0.1）系统强力驱动后端API使用张子恒接口文档开发本程序仍有诸多bug未修复由于开发时修改过很多emlog原有功能及数据库所以使用该程序需要重新安装emlog和数据库1、配置ssl宝塔可免费申请2、安装后端上传源码-导入数据库-修改con
  • 接口测试用例设计详解 知识的宝藏 接口测试测试用例接口测试用例设计python
    接口测试用例设计详解在软件开发中，接口测试是一项重要的质量保证措施，它确保各个组件之间能够正确地通信。黑盒测试是一种常见的测试方法，它只关注输入和输出而不关心内部实现细节。本文将详细介绍如何基于黑盒测试的原则设计接口测试用例，并结合接口文档的技术要求，考虑各种边界条件、异常情况、接口性能和安全性。1.引言接口测试是验证应用程序接口是否按预期工作的过程。黑盒测试是一种测试方法，它侧重于从外部视角测试
  • 小程序如何获取后端的数据 陈丹阳（滁州学院） 小程序javascript前端
    首先看你想要从后台获取什么数据，例如从接口文档中我们需要获取的是一组图片。那么我们需要在你要获取数据页面下的js文件中的date数据下面定义一个数组用来存放我们从后台获取的数据1.发送异步请求获取数据在js文件中的onLoad：function（）函数中打出wx.request()函数会自动补全代码，下面是request函数中各个语句的用途我们可以先在request函数中先打印一下数据看看获取数据
  • 关闭spirng boot集成springdoc-openapi的接口文档 abments springjava
    springdoc-openapi依赖包org.springdocspringdoc-openapi-starter-webmvc-ui2.1.0org.springdocspringdoc-openapi-starter-webmvc-api2.1.0关闭方式#配置文件中添加如下配置springdoc:swagger-ui:enabled:false关键部分代码分析/**************
  • Spring Cloud微服务项目聚合Swagger文档 洛*璃 springcloud微服务javaSwaggerKnife4jgateway
    在微服务架构中，每个服务通常都有自己独立的API文档。为了方便管理和查看所有服务的接口文档，我们需要将这些文档进行聚合。SpringCloud与Swagger的结合可以帮助我们实现这一目标。本文将介绍如何在SpringCloud微服务项目中聚合Swagger文档，以便于集中查看和管理。1.前置条件在开始本文之前，博主希望你已经完成微服务项目的搭建：微服务项目搭建请参考：SpringCloud微服务
  • 免费天气API接口 根据经纬度查询天气预报 Cc琎 天气api天气预报接口
    天气API-对接简单更实用接口文档http://tianqiapi.com/index/doc?version=2030返回格式{"cityid":"101071401","date":"2024-03-13","week":"星期三","update_time":"21:49","city":"葫芦岛","cityEn":"huludao","country":"中国","countryEn":
  • 掌握Katalon Studio 导入 swagger 接口文档，接口测试效率提升100% 程序员雨果 软件测试技术分享软件测试软件测试面试
    katalonstudio大家都已经不陌生了，是一款现在非常主流的自动化测试工具，包括了web、api、APP，甚至PC应用程序都可以使用它来完成自动化测试。swagger是一款RESTFUL接口的文档在线自动生成软件，swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。简单点来讲就，swagger是一款可以根据resutful风格生成的接口开发文档，
  • 前后端分离开发 待╮续 状态模式
    目录前言一、前后端分离开发1.介绍2.开发流程3.前端技术栈（1）开发工具:（2）技术框架:二、Yapi1.介绍2.使用（1）准备（2）定义接口（3）导出接口文档（4）导入接口文档三、Swagger1.介绍2.使用方式（1）导入knife4j的maven坐标（2）导入knife4j相关配置类（3）设置静态资源映射（4）在LoginCheckFilter中设置不需要处理的请求路径3.查看接口文档4.
  • Jmeter上传文件接口测试 咖 啡加剁椒 软件测试jmeter压力测试软件测试功能测试自动化测试程序人生职场和发展
    Jmeter上传文件接口测试接口测试，想必大家都做过，但是上传文件的接口，可能就不知所措。其实呢，还是那么回事~一、接口的业务在接口文档缺失的前提下，那就从抓包玩起~Fiddler或者F12都可以。本次我们接口实现的功能是上传用户头像。F12抓包的截图如下：（接口相关的重点圈出）这里尤其注意下MIME类型，上传文件接口，如果MIME类型发送错误，接口无法调通。二、jmeter调试1、线程组单个接口
  • smart-doc 3.0.2发布，生成的word格式接口文档遥遥领先 后端工具java
    smart-doc是一款同时支持JAVARESTAPI和ApacheDubboRPC接口文档生成的工具，smart-doc利用接口泛型和javadoc注释自动分析生成api接口文档，不采用任何注解侵入到业务代码中。只需要在项目中引入smart-doc提供的maven或者是gradle插件，然后按照规范写好javadoc注释即可生成api文档。同时smart-doc也支持生成openapi和post
  • 推荐一款好用的API接口管理神器！ 小张BOb
    如今，API已在软件、Web和移动应用程序开发领域无处不在，从企业内部到面向公众的应用以及与合作伙伴进行系统集成。通过使用API，开发人员可以创建满足各种客户需求的应用程序。而软件架构也在随着应用程序开发方法的改变而改变。由于API在软件开发过程中如此关键，那么对API的管理就显得格外重要。通过API接口文档管理工具和平台能够大大简化API管理的难度和复杂度。最近总有阿里、腾讯、滴滴的开发朋友提到
  • @(YES)和YES?@1:@0区别何在？ FourV
    后台人员提供了一个网络请求接口，接口文档如下：接口文档.png使用字典将参数传递过来给后台，移动端提供的参数isAttention是BOOL类型，要转换成后台所需要的int类型；因为字典之中键值只能是对象类型，以往都是将int类型包装成NSNumber类型放在字典里进行传递，请求准确无误。方式一：{@"isAttention":@(isAttention)}方式二：[NSNumbernumberW
  • Python+Pytest+Allure+Git+Jenkins接口自动化框架 测试大大怪 pytestgitjenkins测试工具功能测试
    一、接口基础接口测试是对系统和组件之间的接口进行测试，主要是效验数据的交换，传递和控制管理过程，以及相互逻辑依赖关系。其中接口协议分为HTTP，RPC，Webservice，Dubbo，RESTful等类型。接口测试流程1、需求评审，熟悉业务和需求2、开发提供接口文档3、编写接口测试用例4、用例评审5、提测后开始测试6、提交测试报告两种常见的HTTP请求方法：GET和POST二、项目说明本框架是一
  • postman也不行！IDEA接口调试插件 Xayh55 postmanintellij-idea测试工具
    Postman是大家最常用的API调试工具，那么有没有一种方法可以不用手动写入接口到Postman，即可进行接口调试操作？今天给大家推荐一款IDEA插件：ApipostHelper，写完代码就可以调试接口并一键生成接口文档！而且还可以根据已有的方法帮助您快速生成url和params。更重要的是他完全免费！ApipostHelper=API调试工具+API管理工具+API搜索工具。这款插件由Apip
  • 如何交接一个前端项目 coding苏 【前端进阶】前端react.jsjavascript
    一.在非交接状态下，需要做好的事情必要的代码注释必要的文档梳理readme即可，记录重要的信息方便自己查阅、方便新的伙伴快速了解项目二.交接readme2.1项目相关的网址项目git地址不同环境的访问权限（或者对应的测试账号/密码）接口文档地址，如yapi项目发版权限，如devops具体权限需求文档list原型文档listbug管理地址，如jira地址性能监测网站埋点数据统计网站oss存储地址ng
  • AJAX——接口文档 越努力越幸运` ajaxajax前端
    1接口文档接口文档：描述接口的文章接口：使用AJAX和服务器通讯时，使用的URL，请求方法，以及参数传送门：AJAX阶段接口文档接口文档用户登录//用户注册//axios({//url:'http://hmajax.itheima.net/api/register',//method:'post',//data:{//username:'itheima007',//password:'765432
  • AJAX——form-serialize插件 越努力越幸运` ajaxajax前端javascript
    1form-serialize插件作用：快速收集表单元素的值语法：form-serialize插件使用document.querySelector('.btn').addEventListener('click',()=>{/***2.使用serialize函数，快速收集表单元素的值*参数1：要获取哪个表单的数据*表单元素设置name属性，值会作为对象的属性名*建议name属性的值，最好和接口文档
  • 苍穹外卖学习-----2024/02/19 客卿123 苍穹外卖项目学习java
    1.开发环境搭建我的git截图我使用的datagrip运行sql学习到jwt令牌一种新的配置方式，写配置文件学习到了build属性nginx解决跨域的问题2.导入接口的文档结果如图所示3.Swagger/***通过knife4j生成接口文档*@return*/@BeanpublicDocketdocket(){ApiInfoapiInfo=newApiInfoBuilder().title("苍穹
  • Jmeter录制功能 Miss糖豆 Jmeter
    前言在使用Jmeter进行接口或者性能自动化时，前期大部分的工作量集中在将接口信息从接口文档或抓包工具上复制黏贴到jmeter的HTTP请求上。针对上述问题，jmeter提供了录制功能，可录制指定接口请求，然后进行接口请求优化，重新组合成满足需要的接口脚本。Jmeter录制功能：原理：HTTP代理服务器优点：1.支持录制指定请求/支持过滤非必要请求2.支持为将请求按模块/系统前缀明明目的：提高自动
  • Vue3.0商店后台管理系统项目实战-vue3搭配Element Plus框架使用 祈澈菇凉
    侧边栏导航vue3搭配ElementPlus框架使用ElementPlus基于Vue3，面向设计师和开发者的组件库文档：https://element-plus.gitee.io/zh-CN/安装#NPM$npminstallelement-plus--save图片.png安装完成之后开始引入打开main.js的文件这里接口文档上是有说明的，直接根据文档上的教程来写图片.pngmain.jsimp
  • Python调用接口 快速实现艺术图创作 eric-sjq 小思框架AI接口python开发语言AI作画
    我们使用的是小思框架的清韵AI-艺术图创作API；根据描述（同时支持动漫名、动画名、景点名等各种格式）生成各种风格的艺术图像。具体的逻辑是这样的：描述结果用户AI绘画风格转换图片质量检测由于加入了图片质量检测，所以有的提示词可能会生成失败。API接口文档请求类型GETURLhttps://4147093qp2.imdo.co/aidrawnew请求参数参数名类型必填描述textstring是用户提
  • java观察者模式 3213213333332132 java设计模式游戏观察者模式
    观察者模式——顾名思义，就是一个对象观察另一个对象，当被观察的对象发生变化时，观察者也会跟着变化。 在日常中，我们配java环境变量时，设置一个JAVAHOME变量,这就是被观察者，使用了JAVAHOME变量的对象都是观察者，一旦JAVAHOME的路径改动，其他的也会跟着改动。 这样的例子很多，我想用小时候玩的老鹰捉小鸡游戏来简单的描绘观察者模式。 老鹰会变成观察者，母鸡和小鸡是
  • TFS RESTful API 模拟上传测试 ronin47
           TFS RESTful API 模拟上传测试。 　　 细节参看这里：https://github.com/alibaba/nginx-tfs/blob/master/TFS_RESTful_API.markdown 模拟POST上传一个图片： curl --data-binary @/opt/tfs.png http
  • PHP常用设计模式单例, 工厂, 观察者, 责任链, 装饰, 策略,适配,桥接模式 dcj3sjt126com 设计模式PHP
    // 多态, 在JAVA中是这样用的, 其实在PHP当中可以自然消除, 因为参数是动态的, 你传什么过来都可以, 不限制类型, 直接调用类的方法 abstract class Tiger { public abstract function climb(); } class XTiger extends Tiger { public function climb()
  • hibernate 171815164 Hibernate
    main,save Configuration conf =new Configuration().configure(); SessionFactory sf=conf.buildSessionFactory(); Session sess=sf.openSession(); Transaction tx=sess.beginTransaction(); News a=new
  • Ant实例分析 g21121 ant
            下面是一个Ant构建文件的实例，通过这个实例我们可以很清楚的理顺构建一个项目的顺序及依赖关系，从而编写出更加合理的构建文件。           下面是build.xml的代码： <?xml version="1
  • [简单]工作记录_接口返回405原因 53873039oycg 工作
             最近调接口时候一直报错，错误信息是:       responseCode:405 responseMsg:Method Not Allowed        接口请求方式Post.
  • 关于java.lang.ClassNotFoundException 和 java.lang.NoClassDefFoundError 的区别 程序员是怎么炼成的
       真正完成类的加载工作是通过调用 defineClass来实现的；  而启动类的加载过程是通过调用 loadClass来实现的；  就是类加载器分为加载和定义   protected Class<?> findClass(String name) throws ClassNotFoundExcept
  • JDBC学习笔记-JDBC详细的操作流程 aijuans jdbc
    所有的JDBC应用程序都具有下面的基本流程：　　1、加载数据库驱动并建立到数据库的连接。　　2、执行SQL语句。　　3、处理结果。　　4、从数据库断开连接释放资源。 下面我们就来仔细看一看每一个步骤： 其实按照上面所说每个阶段都可得单独拿出来写成一个独立的类方法文件。共别的应用来调用。 1、加载数据库驱动并建立到数据库的连接：   Html代码  St
  • rome创建rss antonyup_2006 tomcatcmsxmlstrutsOpera
    引用 1.RSS标准 RSS标准比较混乱，主要有以下3个系列 RSS 0.9x / 2.0 : RSS技术诞生于1999年的网景公司(Netscape)，其发布了一个0.9版本的规范。2001年，RSS技术标准的发展工作被Userland Software公司的戴夫 温那(Dave Winer)所接手。陆续发布了0.9x的系列版本。当W3C小组发布RSS 1.0后，Dave W
  • html表格和表单基础 百合不是茶 html表格表单meta锚点
    第一次用html来写东西,感觉压力山大,每次看见别人发的都是比较牛逼的 再看看自己什么都还不会,   html是一种标记语言,其实很简单都是固定的格式   _----------------------------------------表格和表单 表格是html的重要组成部分,表格用在body里面的 主要用法如下; <table> &
  • ibatis如何传入完整的sql语句 bijian1013 javasqlibatis
            ibatis如何传入完整的sql语句？进一步说，String str ="select * from test_table"，我想把str传入ibatis中执行，是传递整条sql语句。         解决办法： <
  • 精通Oracle10编程SQL(14)开发动态SQL bijian1013 oracle数据库plsql
    /* *开发动态SQL */ --使用EXECUTE IMMEDIATE处理DDL操作 CREATE OR REPLACE PROCEDURE drop_table(table_name varchar2) is sql_statement varchar2(100); begin sql_statement:='DROP TABLE '||table_name;
  • 【Linux命令】Linux工作中常用命令 bit1129 linux命令
    不断的总结工作中常用的Linux命令   1.查看端口被哪个进程占用   通过这个命令可以得到占用8085端口的进程号，然后通过ps -ef|grep 进程号得到进程的详细信息   netstat -anp | grep 8085   察看进程ID对应的进程占用的端口号   netstat -anp | grep 进程ID &
  • 优秀网站和文档收集 白糖_ 网站
    集成 Flex, Spring, Hibernate 构建应用程序   性能测试工具-JMeter   Hmtl5-IOCN网站   Oracle精简版教程网站   鸟哥的linux私房菜   Jetty中文文档   50个jquery必备代码片段   swfobject.js检测flash版本号工具
  • angular.extend boyitech AngularJSangular.extendAngularJS API
    angular.extend 复制src对象中的属性去dst对象中. 支持多个src对象. 如果你不想改变一个对象，你可以把dst设为空对象{}: var object = angular.extend({}, object1, object2). 注意: angular.extend不支持递归复制. 使用方法: angular.extend(dst, src); 参数:
  • java-谷歌面试题-设计方便提取中数的数据结构 bylijinnan java
    网上找了一下这道题的解答，但都是提供思路，没有提供具体实现。其中使用大小堆这个思路看似简单，但实现起来要考虑很多。 以下分别用排序数组和大小堆来实现。 使用大小堆： import java.util.Arrays; public class MedianInHeap { /** * 题目：设计方便提取中数的数据结构 * 设计一个数据结构，其中包含两个函数，1.插
  • ajaxFileUpload 针对 ie jquery 1.7+不能使用问题修复版本 Chen.H ajaxFileUploadie6ie7ie8ie9
    jQuery.extend({ handleError: function( s, xhr, status, e ) { // If a local callback was specified, fire it if ( s.error ) { s.error.call( s.context || s, xhr, status, e ); }
  • [机器人制造原则]机器人的电池和存储器必须可以替换 comsci 制造
           机器人的身体随时随地可能被外来力量所破坏,但是如果机器人的存储器和电池可以更换,那么这个机器人的思维和记忆力就可以保存下来,即使身体受到伤害,在把存储器取下来安装到一个新的身体上之后,原有的性格和能力都可以继续维持.....        另外,如果一
  • Oracle Multitable INSERT 的用法 daizj oracle
    转载Oracle笔记-Multitable INSERT 的用法 http://blog.chinaunix.net/uid-8504518-id-3310531.html 一、Insert基础用法 语法：     Insert Into 表名 (字段1,字段2,字段3...）     Values (值1,
  • 专访黑客历史学家George Dyson datamachine on
    20世纪最具威力的两项发明——核弹和计算机出自同一时代、同一群年青人。可是，与大名鼎鼎的曼哈顿计划（第二次世界大战中美国原子弹研究计划）相 比，计算机的起源显得默默无闻。出身计算机世家的历史学家George Dyson在其新书《图灵大教堂》（Turing’s Cathedral）中讲述了阿兰·图灵、约翰·冯·诺依曼等一帮子天才小子创造计算机及预见计算机未来
  • 小学6年级英语单词背诵第一课 dcj3sjt126com englishword
    always 总是 rice 水稻，米饭 before 在...之前 live 生活，居住   usual 通常的 early 早的 begin 开始 month 月份   year 年 last 最后的 east 东方的 high 高的   far 远的 window 窗户 world 世界 than 比...更  
  • 在线IT教育和在线IT高端教育 dcj3sjt126com 教育
    codecademy  http://www.codecademy.com codeschool  https://www.codeschool.com teamtreehouse  http://teamtreehouse.com lynda http://www.lynda.com/ Coursera https://www.coursera.
  • Struts2 xml校验框架所定义的校验文件 蕃薯耀 Struts2 xml校验Struts2 xml校验框架Struts2校验
      >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 蕃薯耀 2015年7月11日 15:54:59 星期六 http://fa
  • mac下安装rar和unrar命令 hanqunfeng mac
    1.下载：http://www.rarlab.com/download.htm 选择 RAR 5.21 for Mac OS X 2.解压下载后的文件 tar -zxvf rarosx-5.2.1.tar 3.cd rar sudo install -c -o $USER unrar /bin #输入当前用户登录密码 sudo install -c -o $USER rar
  • 三种将list转换为map的方法 jackyrong list
      在本文中，介绍三种将list转换为map的方法： 1） 传统方法 假设有某个类如下    class Movie { private Integer rank; private String description; public Movie(Integer rank, String des
  • 年轻程序员需要学习的5大经验 lampcy 工作PHP程序员
    在过去的7年半时间里，我带过的软件实习生超过一打，也看到过数以百计的学生和毕业生的档案。我发现很多事情他们都需要学习。或许你会说，我说的不就是某种特定的技术、算法、数学，或者其他特定形式的知识吗？没错，这的确是需要学习的，但却并不是最重要的事情。他们需要学习的最重要的东西是“自我规范”。这些规范就是：尽可能地写出最简洁的代码；如果代码后期会因为改动而变得凌乱不堪就得重构；尽量删除没用的代码，并添加
  • 评“女孩遭野蛮引产致终身不育 60万赔偿款1分未得”医腐深入骨髓 nannan408
    先来看南方网的一则报道： 再正常不过的结婚、生子，对于29岁的郑畅来说，却是一个永远也无法实现的梦想。从2010年到2015年，从24岁到29岁，一张张新旧不一的诊断书记录了她病情的同时，也清晰地记下了她人生的悲哀。 　　粗暴手术让人发寒 　　2010年7月，在酒店做服务员的郑畅发现自己怀孕了，可男朋友却联系不上。在没有和家人商量的情况下，她决定堕胎。 　　12月5日，
  • 使用jQuery为input输入框绑定回车键事件 VS 为a标签绑定click事件 Everyday都不同 jspinput回车键绑定clickenter
    假设如题所示的事件为同一个，必须先把该js函数抽离出来，该函数定义了监听的处理：   function search() { //监听函数略...... }   为input框绑定回车事件，当用户在文本框中输入搜索关键字时，按回车键，即可触发search():   //回车绑定 $(".search").keydown(fun
  • EXT学习记录 tntxia ext
      1. 准备   （1） 官网：http://www.sencha.com/   里面有源代码和API文档下载。   EXT的域名已经从www.extjs.com改成了www.sencha.com ，但extjs这个域名会自动转到sencha上。   （2）帮助文档：   想要查看EXT的官方文档的话，可以去这里h
  • mybatis3的mapper文件报Referenced file contains errors xingguangsixian mybatis
    最近使用mybatis.3.1.0时无意中碰到一个问题： The errors below were detected when validating the file "mybatis-3-mapper.dtd" via the file "account-mapper.xml". In most cases these errors can be d
按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他